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Lab 1 Getting started 


1.1 Bui 





ling and executing a simple message flow 


In this lab, you will build and execute a simple message flow. A message flow is similar to a program but 
is developed using a visual paradigm. 


The flow will be deployed to an integration server in an integration node where it will execute. An 
integration server is an operating system process where user flows execute. The flow will then be 
available to process messages. There is no need to restart the integration node or the integration server 
for the deployment of a new or changed message flow. 


The unit of deployment is a broker archive file (BAR). Broker archive files have a file extension of ‘bar’. It 
is essentially a zip file with a deployment descriptor. The deployment descriptor allows certain properties 
of the message flow to be overridden. 


The broker archive file will hold the artifacts to be deployed to a specific integration server in a specific 
integration node. It may contain applications and libraries as well as message flows, message sets, XSL 
Transformations (XSLT) style sheets, Java™ Archive (JAR) files, XML schema files or WSDL files. In 
addition, the related source files might also be included. When you add a message flow to the BAR file, 
additional validation of the message flow is performed. The BAR file is then deployed to the integration 
node. The final validation of the artifacts is done by the integration node. If errors are found by the 
integration node, they will be reported back in the event log. 


As a convention for these labs, a red box will be used to identify a particular area, and when information 
is to be entered or an action is to be taken, it will be in bold characters. Red lines might be used to 
indicate where nodes are to be placed when building your message flow. 


Icons are provided on the desktop. These are: 


«Integration toolkit 
* Integration console 
+ Integration Bus Explorer (IBM® WebSphere® MQ Explorer) 


The system is Windows 7-X64. The IBM software includes IBM WebSphere MQ Version 7.5, |BM 
Integration Bus V9, Worklight Studio V5.0.6 and IBM DB2® V9.7. The Worklight Studio V5.0.6 includes 
the Android SDK and Eclipse plug-in. Other IBM software is also installed and will be described in the 
later labs. 
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1.2 Getting to know the Toolkit 


The icon for the IBM Integration Toolkit is located in the system tray on the desktop. In later labs, 
you will also be using some of the icons that have been placed on the smart bar. 





Click the icon to start the IBM Integration Toolkit 9.0. 





The splash screen is displayed when starting the IBM Integration Toolkit. 


IBM Software 


‘Launching, plesse wait 
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You are prompted to select an Eclipse Workspace — you will take the default here but this is a 
nice facility to allow you switch between workspaces when starting the toolkit. 


__2. Verify that the C:\student\workspace directory is selected. 


3. Click OK. 


ee) 





Select a workspace 


Websphere Message Broker Toolkit - Message Broker stores your projec in a folder called @ workspace, 
Choose a workspace folder to use fr this session, 








[use this asthe default ana do nat ask again 
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Now take a look around at the Toolkit. 
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Key Idea: The Toolkit 


The Integration Toolkit is based on Eclipse and includes components from IBM Rational® Application 
Developer. It provides one perspective specifically for IBM Integration Bus as well as additional 
Perspectives from Rational Application Developer and Eclipse. This system is using the default 
installation. During the labs and lectures, you will be learning more about the components in a typical 
development and runtime environment. 


The screen capture on the previous page is of the Integration Development perspective. It is divided 
into multiple views (or panes). Each view is identified by a tab at the top of the view. On the lower left is 
the outline view 


(On the upper left is the Navigator view, which has tabs for projects (Integration Development) and 
patterns (Patterns Explorer). The Navigator view contains the projects that are available within the 
Eclipse workspace. There is a set of resources already provided for your use during the labs. 


The area below the navigator view is the summary area. The Integration Nodes tab will show all defined 
local nodes as well as connections to remote nodes that have been created. 


The large area on the right is used by the resource editors. When an editor has opened a resource, it will 
also be represented by a tab. Below the editor view is a pair of views for Properties and Problems. 


On the top right are tabs for the perspectives that have been opened. To change an open perspective, 
you can simply click its tab. 


Quick Start wizards are displayed as links in the center of the screen, which is the default blank palette 
within the Editor view. You can also access these by right clicking whitespace in the Applications view on 
the left. The wizards do some of the initial work for creating various types of solutions. 


The Integration Toolkit provides several Quick Start wizards plus a number of pre-defined patterns to 
assist in creating Applications and Libraries. We will see more of these in later labs 


Eclipse is project-oriented — artifacts are organized into projects. A project is typed. Project types that are 
specific to IBM Integration Bus are Applications and Libraries. Also, legacy projects of type Message 
Flow Project and Message Set Project can be created or imported into the toolkit. Since they pre-date 
the concept of Applications and Libraties, they will be visible in the hierarchy under a Folder called 
“Independent Resources.” 
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1.3 Bui 


__1. Right click the white space of the Application Development pane. 





ing a simple flow 


_2. Select New Application. 


As an alternative, you can click File on the Menu Bar, and select New->Other, type Application in the 
selection box, and click Next. 


Note: These actions are also available as icons on the toolbar. 
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You are prompted to enter a name for your application. 
Enter IntroLab for the application name. 


3 
4. Click Finish. 
rewind 
" 


Create a new application 
‘An application is 2 deployable container that provides izolation at runtime, Enter namefor the new application. | | 






























«tec xe | Eee] 
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Lab T - Getting started 


Now you will create a new message flow. 





_5. Under the IntroLab, click (New.. 
_6. Select Message Flow. 
The options for the New action differ depending on how the request is made. For example, when using 


the File > New from the Menu bar, all of the options will be listed. However, in this case, by starting from 
an application, the only options shown are those that are related to the selected project. 


FE, Application De 52> BE, Patterns Explor) = 





Application Development 





introLab 
fe om} 

Bl MQ Service = 

Bi MQ Service New Artifect 

Bars Create a new artifact. 


G] Independer 
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Here you are asked to name the message flow. An Application might contain multiple message flows. 


__7. _ Enter IntroMessageFlow in the Message flow name box. 
8. Click Finish. 
[Onemenene ei 


|| Create a new message flow 





Select @ container for thenew message flow = 

















eee (EF al } 
‘Message flow name: [iewomessageriow ] | 
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Use default broker schema 
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You are placed into the Message Flow Editor where you can compose the message flow. When you 
lick the Message Flow Editor, information about the message flow appears in the Properties pane. 


9. Select the Properties tab. 





__10. Select the Description tab. 


__11. Enter the following: 


+ Enter 1.0 for the Version field; 
«Enter Introduction to IBM Integration Bus V9.0 for the Short description field; 
«Enter your choice of information in the Long description field. 












Palette of available nodes 














8 Default Values for Message Flow Properties - IntroMessageFlow 


ee] 








Version 10 





Shott description _Intraduction to IBM Integration Bus V2.0 


Long description, 





This ic my First lab = 
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A message flow must begin with an Input node. An input node establishes the environment for the flow. 
There is an Input node for each of the various protocols that IBM Integration Bus supports. We will 
process a WebSphere MQ message with this flow so we need an MQInput node. 

‘The MQInput node is in the WebSphere MQ drawer. 

__12. Open the WebSphere MQ drawer by clicking it. If a drawer is open, it will close when clicked. 
__13. Highlight the desired node (MQInput). 


__14, Either drag it to the canvas or move the mouse to the canvas and click again. 


‘Palette 


Ty Selection 


\ connection 


Qmereply 


Dymocet 


‘BE MoHeader 


MQOptimizedFiow 
NO ereened 
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When a node is initially added, its name can be changed immediately by over-keying the default name — 
or by entering a new value in the Node name field in the Description tab of the Properties. 


A best practice is to provide a new name for each node that is descriptive of the function that it provides. 
For most of the labs, you will be renaming the nodes. If you use the names as suggested it will make it 
easier to follow the lab guide. Another naming convention for MQInput and M@Output nodes is to use the 
queue name that the node is accessing. 

__15. Change the name of the node to XML_Input. 

__16. Press the Enter key to complete the rename. 


The Queue name in the node properties must be set. The Basic tab should be selected. A Queue name 
is required and this is indicated by a message in red. 


__17. Select the Basic tab in the Properties pane. 


__18, Enter LAB.IN as the Queue name. Queue names are case sensitive. All queue names in the 
labs are upper case. 
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__19. Select the Description tab. This section is used for documentation. The name of the node could 
also be changed. The node name is shown in the message flow editor. It does not affect the 
operation of the message flow. 


_20. Enter Q:LAB.IN in the Short description field. 


__21. Enter your choice of text for the Long description (Getting Started is shown in the screen 
shot). 


| [EL Problems) El Deployment Log] 


02, MQ Input Node Properties - XML_Input 
I 











te | Node name 


"iM Input 
nputMessageParing | short description | QLABIN 


Long description 





Parser Options 
Advanced 
Validation 
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__22, Hold the mouse pointer over the node name. 


The information in the Short description field is displayed. When there are multiple nodes on the canvas, 
it you move from node to node with the mouse, the same tab in the Properties will be displayed. 














Graph User Defined Properties 
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The Trace node is in the Construction drawer. 

__23. Open the Construction drawer by clicking it with the mouse. 

__24. Select the Trace node and place it on the canvas to the right of the XML_Input node. As shown 
in the example, when you place the cursor on a node name, a description is shown. You do not 
need to rename the Trace node. 


__25. Press the Enter key to accept the default node name (Trace). 
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(Input 
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__26, In the Basic tab, use the pull-down list on the Destination field to select File. 
__27. Inthe File Path field, enter :\XML_Input_Trace.txt. 


The information in the Pattern box tells the node what information to produce in the trace output. If you 
type a line of raw text, it is echoed to the output. 


__28, Enter a line of your choice in the Pattern box — no quotes are needed. 
__29. Inthe Pattern box, enter the string ${Root} exactly as indicated — this tells the trace node to 


dump out the entire contents of the message that enters the node. Important - the pattern uses 
curly braces, not parenthesis. The expression between the curly braces will be evaluated at run 
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__30. Open the WebSphere MQ drawer. 
__31. Select an MQOutput node from the drawer. 


__32, Place it to the right of the Trace node. 
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__33. While the node name is highlighted, enter Send_As_XML as the new name. 


__34, Press the Enter key to accept the new node name. 





ja 2 
ML Input Trace 





__35. Click the Basic tab on the Properties tab. 


__36. Set the Queue name to LAB.SEND.AS.XML. Queue names are case sensitive. It is a best 
practice to separate words in the queue name with a dot. 


__37. Make sure you did not enter this information in the Queue manager name field, 





properties 52“. [f. Problens| 
I MQoutput Node Properties - Send_As_XML 


a 
Bi (Queue manager name 


Validation 
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Key Concept: Node Terminals 


Output 
Termin 





‘As you work with the various nodes, you will also be working with their Input and Output terminals. Input 
terminals are typically named In. Most nodes have an Output terminal named Out. They may have 
several others. 


‘Some of these will have common names such as Failure or Catch and others will be unique to that 
particular node. Some nodes allow you to define the terminals. The terminals are given a name when 
they are defined. 

The lab instructions will identify the Output terminal to be used when connecting nodes together. If you 
hover the mouse pointer over a terminal, a small popup will appear that identifies the name of the 
terminal. 

You will now wire the nodes together to create a logical path for the message to follow through the 
message flow. The Out terminal of the XML_Input node must be wired to the In terminal of the Trace 
node. There are two techniques: 


One ~ position the mouse over the Out terminal (in the middle), click and drag to the target and click 
again. 


‘Two — right click a node and select Create Connection. This is an example of a Terminal Selection 
presented as a result of the Create Connection. 


The rest of the Lab instructions show the first method for wiring. 
_38. Right click the XML_Input node. 


__39. Select Create Connection from the menu, 
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A\list of the available Output terminals for this particular node type is shown 
__40. Select the Out terminal. 


41. Click OK. 





Fle final nares = any chara, 








Select teint 





@ Gort 


You now have a “rubber-band” connector. 


__42. Position the connector over the Trace node. 


__43. Click the left mouse button to anchor it, creating a connection between the two nodes. 
__44. Place your mouse pointer on the connection. A popup of a summary of “from-to” information will 
appear. 
—— 





la} ep ally 


wmt_tnpuf (Out? 9] trace Serd_As_XML 
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The same steps will be used to make a connection from the Trace node to the Send_As_XML node. 
__45, Right click the Trace node. 


__46, Select Create Connection. This time you immediately get a “rubber-band” connector. No 
selection list of terminals is presented because there is only an Out terminal on the Trace node. 











ox yo i 
a @ Undodelete cuz 
XOML_Inout AS oe 
ctex 
cute 
HE Delete Delete 


__47. Position the mouse pointer over the Send_As_XML node. 


_48. Click the left mouse button to create the connection. 








Your message flow should now look like the above diagram. Notice the small asterisk next to the 
message flow name. This indicates that the message flow has not been saved to disk. 








__49. tis time to save your work — hold down the Ctrl key and press the S key to save the message 
flow. You can also click the “diskette” icon or use File > Save to perform a save. 


The following graphic will be used as a reminder when itis time to save your work, i | 
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1.4 Testing the flow 


The message flow is now complete. The next step is to send it to the runtime environment for testing. 
The integrated Test Client will be used to test the message flow. 


__1. Select the MQInput node (which we called XML_Input).. 
__2. Press the right mouse button. 


_3. Select Test... from the menu. 
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Copy trie 
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__4. Click OK to the popup. 
© conirm 2 Ex) 


‘The message flow ‘Intro_MessageFlow.msgflow’is owned ay an Application ora 
Library and can net be deployed individually. The owning Application or Library will 
be depleyed instead, Do you want to continue? 
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Take a moment to familiarize yourself with the Test Client: 
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Events 












“The flow this Test Client is using, and the name of 
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Key Concept: Test Client 


Test Client instances can be created for MQ, JMS, HTTP, SOAP and SCA input nodes. They exist as a 
single file in the workspace with a .mbtest file extension. They can be embedded into the Applications or 
Libraries and thus passed from developer to developer with a project. 


The Test Client has many useful features such as monitoring all supported output paths through a flow 
and storing sample messages to a data pool. It also encapsulates the build and deploy process, and can 


be used to launch the debugger. Since it encapsulates a full test, including data, it can be used for 
regression testing. 
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__5. Select Import Source... 
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_6. Navigate to the C:\student\intro_XML_Message folder. 


__7. Select IN_Request file. The Type should be XML Document. 
_8. Click Open. 
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The XML sample message is now loaded into the Test Client. 


Select the Configuration tab. 
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__10. Select Deployment. 
11. Click the Change button in Section 3: Deployment Location. 
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Note that the local Integration Node (IB9NODE) and the Integration Server (default) are displayed. 
_12. Select the default integration server. 


13. Click Finish. 
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__14. Switch back to the Events tab. 


__15. Click the green Play button. (The Send Message button will also do the same thing.) 
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What happened? We received an error when the Test Client attempted to launch. It could not connect to 
the queue and gives us a clue by asking whether or not it has been created. We did indeed forget to 
create our queues! 














Frere tet 
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To create the queues, we will switch to the Administrator tool called the IBM WebSohere MQ Explorer, 
which includes Integration Bus Explorer as well. 


__16. Find the WebSphere MQ Alert Monitor in the Windows system tray. 
__17. Press the right mouse button. 


__18. Select WebSphere MQ Explorer from the menu. 


‘WebSphere MQ (Installation1) 


Open 
Bit 





‘Stop WebSphere MQ 
‘About WebSphere MQ 
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‘Take a moment to familiarize yourself with the Explorer. This tool will be used again in later labs. 
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Key Concept: Integration Explorer (sometimes also called MQ Explorer) 





The Integration Explorer is a lightweight Eclipse tool for the administration of your Integration Bus and 
MQ topology. Technically, the Integration Explorer is an extension to the MQ Explorer that adds 
Integration Bus administrative capabilities to the tool. A few examples of these tasks include adding, 
modifying or deleting Brokers, access control, the deployment and modification of Apps and Libraries, 
viewing Administrative and Event logs, and administering the MQ Pub or Sub engine. 
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__19. Expand IB9QMGR (if necessary). 
__20. Right click the IB9QMGR-> Queues folder. 


__21. Select New>Local Queue. 
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__22. Inthe dialog, for the Name of the queue, enter LAB.IN. 


__23. Click Finish. 





Create a Local Queue 
Enter the details of the object you wich to create 








Select an existing object from which to copy the attributes for thenew object. 





“SYSTEM.DEFAULT.LOCAL QUEUE 





When this wizard completes, another ward can be started automatically to create a matching object. 
star wizard to create @ matching JMs Queue 








@ <a [eas = 
































Tab 1 - Getting started Page 35 


__24, Click OK to close the dialog. The dialog confirms that the queue was created successfully. 


IBM WebSphere MQ 








@ The object was created successfully. (AMQ4148) 


[7]Do not show success messages in future 
(To re-enable, go to the MQ Explorer preferences) 























__25. IMPORTANT! Repeat steps 20 through 24 to create a queue called LAB.SEND.AS.XML 
Now we are ready to retry the Test Client. 

__26. Switch back to the Test Client in the WebSphere Message Broker Toolkit. 

__27. On the left, select the Event called Invoke Message Flow. 


_28. Press the right mouse button. 


__29. Select Re-run from the menu. 
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This time it runs to completion. Recall that the output from our flow was a queue. By selecting the event 
starting with MQ Queue Monitor..., we see the output message. In other words, the Test Client did a 


“GET” operation off of the output queue and displays the message. 
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__30. Select File->Save to save the IntroLab.mbtest test client configuration. ac] 
__31. In the dialog that appears, select the IntroLab application. 
_32, Click Finish. 


Save Execution Trace 








‘Save the execution trace and all test configurations of 
IntroLab.mbtestin a file. 








Enter or select the parent folder: 
Introlab 





b 





1 BARTiles 
‘ie CUSTDE 





| Be Masenice 
i) 1 MQ Service Libray 
1 TestClientBarFiles 








Filename: IntroLab.mbtest 
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The output of the Trace Node in the file system will be examined next. 
33. Bring up Windows Explorer. 
34. Select the Local Disk (C:) folder (root directory). 


35. Double click XML_Input_Trace.txt. 
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Viewing the contents of the trace file, you can see the line of raw text you configured for the Trace node 
to display, as well as some detailed information about the message. 


__36. To see the actual payload or application data, scroll down to the bottom (Ctrl+End). 


Hmmmm...what’s going on here? The message is a BLOB — a Binary Large Object. Just a string of bytes 
shown in hexadecimal. What happened to the XML message? Where are the tags? What about the data! 
All will be resolved soon! 












epimers: a 























__37. Close the Notepad window. 


__38. Minimize the Windows Explorer window. 


Each time that you test the message flow new data will be appended to the end of the trace file. You will 
need to scroll down to the end of the file to see the latest information. 


This is the end of Lab 1. 
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Lab 2 Message models and working with XML messages 


2.1 Overview 


In this lab, the IntroMessageFlow will be modified to identify the parser (KMLNSC) to be used to process 
the message. 


The steps are very simple. 
The properties of the Input node will be modified. 
The Test Client will be used to run another test. 


The trace file contents will be viewed to see the difference. 


2.2 Using the XML Parser 
__1. Return to the IBM Integration Toolkit. 


Click the IntroMessageFlow tab to bring the message flow into view. 








__3. click the XML_Input node to bring its properties into view. 


ef yo bp— $+ Fl 
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The message flow will be modified so that it uses the XMLNSC parser to process the input message. 


4, On the Properties view at the bottom of the screen, click the Input Message Parsing tab. Since 
nothing was specified when the node was added, the Message domain (that is, the parser) 
defaults to binary large object (BLOB) — which you saw in the trace. 


5. Click the pull-down for the Message domain. The various parsers are listed along with a short 
description. Depending on the Message domain selection, the other fields may be enabled or 
disabled. 


6. _ Select the XMLNSC parser. The XMLNSC parser that supports Namespaces (the NS part) and 
builds a more efficient or compact tree (the C part). The compact tree uses less memory. 
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Key Idea: Parsers and message domains 


IBM Integration Bus supplies a range of parsers to parse and write messages in different formats. 


A parser is called when the bit stream that represents an input message must be converted to the format 
that is used internally by the broker; this process is known as parsing. The input is a bit stream, and the 
output is a logical tree representation of the message. 


A serializer is called when a logical tree structure must be converted into a bit stream (for example on an 
Output node). This process is known as serializing. 


Each parser is suited to a particular class of messages, known as a message domain. The following list 
contains some examples of the message domains used in IBM Integration Bus: 

XMLNSC - for XML documents 

DFDL — for general text or binary data streams including industry standards 

JSON - for JSON documents 


*  DataObject — for data without a stream representation (used by adapters) 
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Now, let's re-run the Test Client. 

_8. Switch back to the Test Client (IntroLab tab). 
Select one of the Invoke Message Flow items. 

__10. Press the right mouse button. 


__11, Select Re-run from the menu. 


Stevens: aR = 
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You again see the same output message from the Test Client. 


ch pemaprn mp — saci 














This is only what the output message looks like after it arrives on the output queue. Let's see what the 
message looked like while it was passing through the message flow. 
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__12, Return to Windows Explorer. 


13. Navigate to the file at C:\XML_Input_Trace.txt. 


14. Double click XML_Input_Trace.txt file. 
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__15, Scroll to the end of the file (Ctrl + End). 
Trace output is placed at the end of any existing content in a file, so scroll down to the bottom of the file 
and view the results. Much more pleasing...here is a nicely formatted message tree that will allow you to 
conveniently access the fields in the XML message by name. Notice: 

+ The XMLNSC Domain name (which is what we set on the input node). 


+ Allof the element types are String represented by the (CHARACTER)! Why is that? The answer 
requires understanding both Parsers and Message Models. 














__16. Close the Notepad window. 


__17. Minimize Windows Explorer. 
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2.3. Creating a Message Model from an XSD 
In this portion of the lab, we will use a message model to parse the XML message. 


Key Idea: Message Models 


Much of the business world relies on the exchange of information between applications. This information 
is contained in messages that have a defined structure that is known and agreed to by the sender and 
the receiver. 


Applications typically use a combination of message formats, including those message formats that are 
defined by the following structures or standards: 


+ Comma Separated Values (CSV) 

* COBOL, C, PL!, and other language data structures 

+ Industry standards such as SWIFT, X12 or HL7 

+ XML including SOAP 

You can model a wide variety of message formats so that they can be understood by IBM Integration 
Bus message flows. When the message format is known, the broker can parse an incoming message bit 
stream and convert it into a logical message tree for manipulation by a message flow. 


‘Some message formats are self-defining and can be parsed without reference to a model. However, 
most message formats are not selt-defining, and a parser must have access to a predefined model that 
describes the message if itis to parse the message correctly. 


An example of a self-defining message format is XML. In XML, the message itself contains metadata in 
addition to data values, and it is this metadata that enables an XML parser to understand an XML. 
message even if no model is available. Another example of a self-defining format is JSON. 


Examples of messages that do not have a self-defining message format are CSV text messages, binary 
messages that originate from a COBOL program, and SWIFT formatted text messages. None of these 
message formats contain sufficient information to enable a parser to fully understand the message. In 
these cases, a model is required to describe them. 


Even if your messages are self-defining, and do not require modeling, message modeling has the 
following advantages: 


+ Runtime validation of messages. Without a message model, a parser cannot check whether 
input and output messages have the correct structure and data values. 

+ Enhanced parsing of XML messages. Although XML is self-defining, all data values are treated 
as strings if a message model is not used. If a message model is used, the parser is provided 
with the data type of data values, and can cast the data accordingly. 

+ Code completion assistance when coding transformation. When you are creating ESQL 
programs for your message flows, the ESQL editor can use message models to provide code 
completion assistance. 

+ Graphical mapping. Without message models, you cannot use the Message Mapping editor. 

+ Reuse of message models, in whole or in patt, by creating additional messages that are based 
on existing messages. 

* Generation of documentation. 
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+ Provision of version contro! and access control for message models by storing them in a 
central repository. 


Message models allow the full use of the facilities that are offered by IBM Integration Bus. 


To speed up the creation of message models, importers are provided to read metadata such as 
header files, COBOL copybooks, and EIS (Enterprise Information System, such as SAP) metadata, 

and to create message models from that metadata. Additionally, predefined models are available for 
common industry standard message formats such as SWIFT, EDIFACT, X12, FIX, HL7, and TLOG. 


The XML Parser was run in programmatic mode where it parsed the XML message, so it assumed 
everything was a string. By parsing with a model, we can get a message with typed elements and 
one that is subject to constraints (such as required fields, maximum field lengths and so on). The 
toolkit provides wizards to import your existing models (such as WSDLs, XSDs, copybooks and 
others.) 

__1. Inthe Application Development view (project navigator) on the left, right click the white space. 


_2. Select New->Message Model... from the menu. 


Application Development. 






4 Bilntrotab 
4 22 Flows 


IntroMessagcFlow.magfiow| 


Message Flow Test Events 


a6|5 oe 








> (B Flow Tests 
i MQ Senice mae 
> BA MQ Senice Library eee 
> Gi BaRs 
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— J Delete BB SQL File 
Move. {8 Broker Schema 
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Select the Other XML radio button (under XML). 
Check out some of the other options for which there are import wizards. 


Click Next. 








Se Sa 





Create a new message model file = 
Select the messege modeltype or format = 
XML 


XML data for use in Web Services 
All other XML data, 


‘Comma Separated Values data, a delimited tert format commonly used as an export 
format by spreadsheets and databases, 


Text dete formats where delimited fields ere grouped inte records. 
Data for COBOL programs 

c Data for C programs 

Other text or binary All other text or binary data formats. 





Enterprise Information Systems 
Data from SAP systems including IDoc and BAPI 
Data from Siebel systems 

Data from PeopleSoft 

Data from JD Edwards systems 


Data from CORBA 
Records from relational databases, 
Data for extended email format 
Predefined data format 








Back 
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Select the | already have an XML schema for my data radio button. 











Click Next. 
a 
Other XML 
xSD 
|) choosehow you woul eto cesteyour XML mesogerodeh \ 





WebSphere Message Broker can parse and serialize your XML documents without a message model, but requires 3 
‘modelif you want to validate the XML is correct. A message model also speeds up development of your message 
broker applications by enabling ESQL content assist and graphical maps. 


© Create an XML schema file using an XML document as an exemple 
© Create an empty XML zchema file, will model my data using the XML schema editor 
D 











@® <Back [New _] 
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_8. Click the New... button next to the Application or Library field 








Create a new message model file from an XML schema file 
Identify the XML Schema file to import into the workspace 








Application or Library: [ 








Folder: 





XML Schema file: | <Default isthe imported file's name. Select one belov.> 








© Select file from workspace: 





Tl IntioLab 

Fi Ma sence 

| BA MQ Service Library 
[i BARS 

Independent Resources 











(© Select file from outside workspace: 











[ese 














Finish 
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__9. Inthe popup dialog, select Library. 
10. Click OK. 


D crete new entsner ft] 


Choose which container to create 











__11. In the popup dialog, type IntroLabLib as the Library name. 








_12. Click Finish. 
SL =o 


Create a new library 
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a3 


Back in the Message Model wizard, check the radio button Select file from outside workspace. 
__14. Click Browse... 











Create a new message model file from an XML schema file 
Identify the XML Schema file to import into the workspace 





Appleton or bay (slai 





Folder: 








XML Schema file: 





( RoeFae ee enperied fe aie Seles one elon 





© Select file from workspace: 








Sl Ma.Service 
| BA IntoLabLib 
Bh MO Service Library 
BARS 
5 Independent Resources 




















Location 

















< Back h 
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15. Navigate to C:\Student\intro_XML_Message folder. 
16. Select IN_Request.xsd. 




















_17. Click Open. 
3 Open a = 
ee —s 
Eq LocatDisk(C) > student > Intro XML Message + | 44])[ Search intro XML Message | 

Organize + New folder , of @ 
|| Hl Desktop: * Name i Date modified Type F| 





bang [ee] atsnoctschemarie | 


El Recent aces 





2G Libraties 
» BB Documents 
a) Music 
 Picures 
HE Videos 


«188 Computer 
1 Gy Local Disk (C3) 
1G Shared Folders (\ 





~ (Bh ii ] , 














File name: IN Request 
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18. Back in the Message Model Wizard, click Finish. 


‘Qrennatd  te 








| Create a newmessage model file from an XML schema file 
|| Identiy the XML Schema file to import into the workspace 


Ee 








>} [New 








Browse 





‘Applicaton or bray [IirLabLib 
Folder: 
XMLSchemafile: [IN Requested 





© Select file from workspace: 
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© Select file from outside workspace 


Location 
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You now have a Library project with the XML message model for the input message. 








Ti eaten Epos] 





‘Application Development New. 


4 Biinrolab 
2 GS Flows 
BA IntroMessayeFlowmsgflow 
4 Gl Flow Tests 


introlab.mbtest 
© BU MQ service “xo 
4 (BA Introlablib: 
“2-5 Schema Definitions 
44-8 http://wonw.ibmlab.com 


(5) IN Requests 
> ah MQ Service Library 





Key Idea: Library Projects 


Applications and libraries are deployable containers of resources, such as message flows, message 
definitions (DFDL, XSD files), JAR files, XSL style sheets, and WebSphere Adapters files. 


A library is a logical grouping of related code, data, or both. A library contains references to reusable 
resources, such as a message model or map. A library can refer to a resource that is contained in 
another library. Libraries are optional. They are typically used to reuse resources. Libraries can be either 
embedded in an application (private) or obtained by a message flow (that is not part of an application) 
dynamically at run time (execution group level). Use multiple libraries to group related resources (tor 
example, by type or function). 


Consider using libraries if you want to share routines and definitions with multiple teams, projects, or 
brokers. Libraries are also useful if you need to use different versions of a coherent set of routines and 
definitions. 


Using a library is typically not necessary if you do not need to regularly reuse IBM Integration Bus 
routines or definitions. 
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Notice that the XSD is opened for you after import and is visible using the XML Schema Editor which 
shows you both a GUI representation of your XML schema as well as the source. In_Request is the only 
Global element. If you double click it, you can drill down into its structure. 


__19. Double click the In_Request element to view the message elements. 
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Desig Source 


The message model should now be visible. 

















aint |__| Eth RequestTypa) 
[el ActionRequest string 
(Z| DateRequest string 
{| customerNumber — int 
[eustomerName string 
"fe customerDetails _(customerDetailsType) 
[El contactDetsils __(contactDetailsTypa) 


[El requestDecsion string 








El comments string 





__20. Select the Detailed view. 
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‘Some elements, such as customerNumber and customerGreditScore, are integers (ints) and not strings. 





Bertone bea Type 
Tleutamehdsrert ang 
(customerideres2 sting 











IF customercity sing 
(el customarsate (ouromessteType) + 
CFJeustomerCountiy sting 








[El cuctomarPortaCode sting 
‘astomerGrediLimit ine 
‘SlewlomeDeals —(auxtomeDetalyee) oe 
‘EleontactDetls ——(contaetDetaisType) 


(elrequetOecivion string 
{Bl comments string 





TH eontseeieTypa) 
TWicontacrteme ang 
= BleontactastName ting 
Tl conactPhoneNuméer suing 


























__21. Close the IN_Request.xsd tab. 


5 IntreMessageFlow.msgflow “IntroLab (SIN Requestosdf=] 


Now, let's update the message flow to use the message model when parsing incoming messages. 








__22, Inthe project view on the left, select the IntroLab application, 
__23, Press the right mouse button. 


__24, Select Manage Library references. 





EB Patterns Explor) = 6 






New 


a A 


SSE Manage inuded projects 






44 BA IntroLat ‘SE Focus on Application 


© ES Sche A Convert to Library 
> BA MQ_Ser 
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__25, Select the IntroLabLib check box. 
26, Click OK. 


D Menage Library references ==) 





‘Check the libraries to be referenced. Any other 
libraries referenced irom the checked library 
will also be include. Leaving a library 
unchecked will prevent the libraries from being 
includeé. 


Bi\introLabLib| 


TTENMO-Senice Library 





“The following libraries will ao he included a= 
they are referenced by the checked libraries, 














We need to tell the parser to run in schema-driven mode, rather than operate in programmatic mode. 











__27. Click the Intro_MessageFlow.msgflow tab to return to the message flow editor. 
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__28, Single click the XML_Input node, in order to edit its properties. 
__29. Inthe Properties view, click the Validation tab. 


__30. In the Validation dropdown, select Content. 





j [Epa | ama Rope z 





110 input Ne Properties = x_input 














__31. Select the Parser Options tab. 


__32. Select the Build tree using XML schema data types check box. 












| Pacetiming (GEDuaaa = 
Input Message Patsing | | Use MQRFH2C compact parser for MQRFH2 header 


XMILNSC Parser Options, 
ld tee using XML schema data types 
Jee XMUNSC compact parser for MINS domain 


Retain mixed content 
Retain comments 
[Retain processing instructions 


_33. PB ono the message flow (Ctrl+S). 
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2.4 Re-running the Test Client 
The flow will now be run again. The trace output will then be examined. 


__1. Inthe editor, select the IntroLab.mbtest tab (or reopen from the App in the navigator). 


IntroMessageFlow.msgflow ees oa 
__2. Right click Invoke Message Flow. 
3. Glick Re-run. 


The tooling will automatically rebuild and redeploy the App with the dependent Library included. 

















Events 

Message Flow Test Events 6 
> =| 7 ro 
> Ey Invoke Message Flow Me 
» Ef Invoke Message Flow ery 











Tnvoke 
Duplicate 


Rename 
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Return to the Windows Explorer window. 





__5. Double click the C:\XML_Input_Trace.txt file. 
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__6. Scroll down to the end of the file (or use Ctl+End), and view the new trace output. 
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__7. Close the Notepad window. 
__8. Minimize Windows Explorer. 


This is the end of lab 2. 
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IBM Software 





Lab3 Content-based routing and the Debugger 


3.1 Overview 
In this lab, you will perform simple routing. Input messages will be sent to one of three destinations 
depending on the country code. Addresses in the United States will be sent to a US shipping queue, 


while addresses in Canada will be sent to a Canadian shipping queue, and those that are not in the 
United States or Canada will be sent to a third queue. 


3.2 Add routing logic 
1, Return to the Integration Bus Toolkit. 
Select the IntroMessageFlow message flow in the message flow editor. 


Select the Trace node. 





4. Press the Delete key. 





“holed _] 














(@ WebSphere Adapters: 
__5. _ Expand the Routing drawer in the Palette. 


6. Select a Route node and place it between the XML Input and Send_As_XML nodes. 
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IBM Software 


__7. Change the name of the new routing node to CheckCountry. 


__8. Press the Enter key to complete the rename operation. 








ce 


XML_Input Checkouts 


__9. Wire the Out terminal of the XML_Input node to the In terminal of the CheckCountry node. 





__10. Wire the Default terminal of the CheckCounty node to the Send_As_XML node. 





+o ja ® 
A CheckCountry A 

Terminals will now be added to the CheckCountry routing node for US and Canadian addresses. 
__11, Select the CheckCountry route node. 


__12, Press the right mouse button. 


__13. Select Add Output Terminal from the menu. 








aes [alk 
*"| Undo Remove Terminal CtrleZ 
Shek Redo Ctrl 


Create Connection 








Remove Output Teminal 


__14, Enter US as the name of the new output terminal. 


__15. Press the OK button to continue. 


eZ ame of the new output terminal 


Cancel 
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IBM Software 


The steps will now be repeated to add a terminal called Canada. 
_16. Select the CheckCountry node. 
__17. Press the right mouse button. 


__18, Select Add Output Terminal from the menu. 


ja 32] J Undo Move cleZ 


XML Input (CheckCo) > Redo Ctrl+¥ 





Create Connection 








Remove Output Terminal 
19. Enter Canada as the name of the new output terminal. 


__20. Press the OK button to continue. 





Enter name of the new output terminal 








Cancel 
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IBM Software 


Two additional output destinations will now be added. One will be for addresses within the United States 
and a second one will be for addresses within Canada. All other addresses will be sent to the existing 
‘output queue. 

__21. On the Palette expand the WebSphere MQ drawer. 

__ 22. Select an MQOutput node. 

__23. Place the new node below the Send_As_XML node. 

__24. Change the name of the node to LAB.US.OUT 


__25. Press the Enter key to complete the rename operation, 













Peale 


ap al 


Checkcouniny Send. sm 


__26. Inthe Properties pane select the Basic tab. 


__27. Enter LAB.US.OUT as the Queue name parameter. 














Queve manager nane | 


ueve nane Eexy 





Request 
Velden 
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IBM Software 


__28, Select the MQOutput node in the WebSphere MQ drawer again 

__29. Move the mouse pointer to a point below the LAB.US.OUT node. 

__30. Press the left mouse button to place the new node below the LAB.US.OUT node. 
__31. Change the name to LAB.CANADA.OUT. 


__32, Press the Enter key to complete the rename operation, 









__33. In the Properties pane select the Basic tab. 


__34. Enter LAB.CANADA.OUT as the Queue name parameter. 














Quovemenager nana 





__35. Right-click the CheckCountry route node. 


__36. Select Create Connection from the menu, 








ad Output Terminal 
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__37. Inthe Terminal Selection popup, select US. 


_38. Click OK. 








__39. Drag the wire that appears to the LAB.US.OUT node. 


__40. Press the left mouse button to complete the connection. 


ia —- ak 


LAB.US.OUT 









LAB.CANADA.OUT 


__41, Another way to make a connection is just to click the terminal itself. Try this by selecting the 
output terminal of the CheckCountry node. 


__42. Press the left mouse button. 
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Because there are too many terminals to individually depict graphically, a dialog box appears allowing 
you to select the proper terminal. 


__43. Select the Canada terminal. 


__44, Press the OK button. 


Share 





__45, Drag the wire that appears to the LAB.CANADA.OUT node. 


__46. Press the left mouse button to complete the connection. 


ie—- 








XML Input eckCourt 





LAB.CANADA,OUT 
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The criteria to be used by the CheckCountry routing node must now be specified, 
__4T. Select the CheckCountry node. 
__48, In the Properties pane, select the Basic tab. 


__49. Press the Add button. 
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__50. Use the drop-down menu to select the US terminal as the Routing output terminal. 
__51. Press the Edit... button. 


(0) Add Fiker table entry xi| 
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__52. Expand $Root. 
__53. Select (Add Data Type ...). 
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__54. Select In_Request. 
Note: If you do not see In_Request in the list, then you must add a reference to the Library by right 
clicking the IntroLab application and selecting Manage Library references. 


__55. Press the OK button to continue. 


© Type Selection ee x] 


a 








Chooses type (? = any character, *= eny string): 





Matching types: 


eee 





Quali 








ht /wmiteab.com 


|| Domain: { XMLNSC 
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wPath 





XPath Expression Builder 


sewer below. 
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Expand the tns:In_Request->customerDetails elements. 


Select the customerCountry element and drag it into the XPath Expression dialog box. 





Data Types Viewer 


Path Functions 





Operators 
(Bad Data Type.) 2] Gi sting 1 2 
4 [| tnsiIn_Request [XMLNSC] & Boolean r 
[H] ActionRequest: string ‘i Numeric 
{El DateRequest: string Ci Nodeset 
{El customertlumber:int oS Aes 





[fj custonertlame: string 
4] customerDeaile 
[fj customerAddrece : tring 
[El custererdeleress?: string 
lel customerCity: sting 
[el customerStete: string 






and 


> Namespace settings 
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__58, Drag an equal sign from the Operators pane to the end of the expression. 


__59. Append the letters ‘US' (including the single quotes) after the equal sign. 


_60. Press the Finish button to complete the XPath expression. 








XPath Expression Builder 
Select the target from the Schema viewer, Function viewer of Operator viewer and drag end drop the nodes inthe source 
siewer below. 











Data Types Viewer XPath Functions Operators 
(ad Data Type.) a] Ga) Sting z 
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le| custemeCountry: sting 
4 ioeenaea * 
[lShow YML Schema groups 
XPath Expression 








| ocVMINSCinsin_Reques/ustomerDdal/cusioreCounty 


> Namespace settings 
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__61. Press the OK button to complete the Filter table entry. 
Qrddfitertableentty — 
Fiterpattem* 
| SRooW/XMLNSC/tnsiin Request/customerDetails/customerCountry="US'_| [Edit 
Routing output terminal 
{us 

















The filter pattern for the US terminal should now be visible. The process will now be repeated to create a 
Filter table entry for the Canada terminal. 


__62. Press the Add button to enter a filter pattern for the Canada terminal. 
Ei Propeiee Tf Prater) Et Deployer ag 


“i Route Node Properties CheckCountry 
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__63. Use the drop-down menu to select the Canada terminal as the Routing output terminal. 


__64, Press the Edit... button. 





© Add Filter table entry = 





Filter pattem* 


Lo 


Routing output terminal 
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__65. Expand Root>tns:In_Request->customerDetails. Tip: If you do not see In_Request in the 
Viewer, re-add it as done in steps 53-56. 


__68. Select the customerCountry field and drag it to the XPath Expression window. 


Wah 


XPath Expression Builder 


sewer below. 


Sslect the target from the Scheme viewer, Function viewer ot Operator viewer and drag and drop the nodesin the source 








[fj custonertlame: string 
4] customerDeaile 
[fj customerAddrece : tring 
[El custererdeleress?: string 
lel customerCity: sting 
[el customerStete: string 


ts festomercounty song] 
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> Namespace settings 


Data Types Viewer XPath Functions Operators 
E (Béd Data Type.) GH String 1 
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Finish 
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__67. Complete the XPath Expression by typing ="CA’, 


__68. Press the Finish button to complete the XPath expression. 





XPath Expression Builder 








Data Types Viewer XPath Functions Operators 
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69. Press the OK button to complete the Filter table entry. 


ee 


Filter pattern” 











| Rool/XMLNSC/tnsin_Request/customerDetils/customerCounty='CA’ 





Routing output terminal 





= 








The filter pattern for the Canada terminal should now be visible. 
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The updates to the message flow are now complete. 


70, sore tne message fow. 
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3.3. Test with the debugger 


Next, we are going to test the application with the graphical debugger. 
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Key idea: The graphical debugger 


Use the flow debugger in the IBM® Integration Bus Toolkit to track messages through your message 
flows. 
































Use the debug perspective in the IBM Integration Toolkit to use the flow debugger. The diagram above 
introduces the debug perspective and the views it presents. 


You can set breakpoints in a message flow, and then step through the flow. While you are stepping 
through, you can examine and change the message variables and the variables used by ESQL code and 
Java code. You can debug a wide variety of error conditions in flows, including: 


+ Nodes that are wired incorrectly (such as outputs that are connected to the wrong inputs) 
+ Errors in transformation or logic within your code or maps 

+ Incorrect conditional branching in transition conditions 

+ Unintended infinite loops in flow 
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From a single IBM Integration Toolkit, you can attach the debugger to one or more integration servers, 
and debug multiple flows in different integration servers (and therefore multiple messages) at the same 
time. However, an integration server can be debugged by only one user at a time. Therefore, if you 
attach your debugger to an integration server, another user cannot attach a debugger to that same 
integration server until you have ended your debugging session. 


1. Inthe Integration Node view in the bottom left, right click the Integration Server called default. 


2, Select Launch Debugger from the menu. 


1B TestClient 






Deploy... 


‘Stop 
Refresh 


Delete » 


Launch Debugger (Portis 14999) 








In the subsequent Launch Debugger dialog, select OK. 


a 








Debugger will be launched using port 14999, 


To use another pot, click "Configure 


ror er | 


__4, Inthe IntroMessageFlow, right click the wire between the XML_Input node and the Check 
Country route node. 























__5. Select Add Breakpoint from the menu. 








(ah lakh 

Undo Culez 

Redo Curley 
% Delete Delete 


‘Add Breakpoi 
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__8. Inthe main editor view, bring into focus the IntroLab Test Client. 


8 IntroMessageFlonmsgflow fe oe 


__7. Along the bottom of the Test Client select the Configuration tab. 
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8. Along the right within the Deployment Location section, click the box called Change. 
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__10. Press the Finish button. 
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Deplayment location: 


|| 2 iesreeese New Locel Integration Node » 
Se defoult Connect to Remote Integration Node 
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‘Stop at the beginning of the flow during debugging 
‘Always use the same deployment location for every test run 
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The debugger will now run next time the Test Client is run. 

















Tab 3 — Content-based routing and the Debugger 


Page 83 


Page 84 


IBM Software 


walt? 


12. 


Events 


Messige Fo Test vents 


‘Switch back to the Events tab. 


Right click on the last Invoke Message Flow in the Message Flow Test Events. 
__13, Select Duplicate from the menu. 
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__14, In Detailed Properties, the Body should now show Edit as text. If not, use the drop-down to 
select it. 
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__15. Edit the input message. Locate the customerCountry element. 
_16. Change the data value to US. 


__17. Run the test client by clicking Send Message. 
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A popup will confirm switching the Eclipse perspective to the Debug perspective. 


18. Press Yes. 


(Ce a a 


@ This kind of launch is configured to open the Debug perspective when it suspends, 








‘This Debug perspective is designed to support application debugging. It 
incorporates views for displaying the debug stack, variables and brezkpoint 
management. | 


Do you want to open this perspective now? 


Remember my decision 
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19. Ensure that the IntroMessageFlow thread is selected in the top left view. You should see a 
yellow halo around the breakpoint. The yellow halo indicates that this is where execution of the 
flow has been suspended. 


Foe0T Aiwa Se 
2 Sed a Ba) 
‘P ieearecssam 
‘Boerne Tin Met el aig 

















__20. In the top right Variables view, expand Message->XMLNSC->In_Request->customerDetails, 


__21. You will see that the value is set to US. 





0 Breakpoints| 





Name Value 
4 @ Message 
> ® Properties 
> % MQMD 
4 & XMLNSC 
> @ XmiDeclaration 
4 @ In Request 
@ ins http://wwwibm.ab.com 
@ sd http://www.v3.org/2001/XMLSchema 
o si http://www.v3.org/2001/XMLSchema-instance 
@ ActionRequest ° 
® DateRequest 10/12/2005 
® customertumber 1 
@ customerName ‘ACME Hardware 
4 @ customenDetails 
® customerAddressl 1254 Main St 
® customerAddress2 Suite12 
® customerCity Dime Box 
_customerState x 
customerCount Us 
@ customerPostalcode 76543 
© customerCreditlimit, 1200 
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__22, To interactively change this, single click the Value column of the customerCountry element. 
__23, Change the value in the editor box to CA. 


__24, Press Enter to update the value. 





9 Breakpoints 





Name Value 
4 @ Message 
> ® Properties 
 MQMD 
4 @ XMLNSC 
> @ XmiDeclaration 
4 @ InRequest 





@ tins hitp://wowiamlab.com 
@ sd hitp://wow.v3.org/2001/XMILSchema 
oi hetps//ww.v3.0rg/2001/KMILSchema-instance 
@ ActionRequest ° 
© DateRequest 3002/2005 
@ customeNumber 1 
@ customeName ‘ACME Hardware 
4 @ customeDetails 
® customerAddresst 1254 Main St 
@ customerAddress2 Suite 12 
© customerCity Dirme Box 
© customesstate % 
@ customerCouniny 
© custemePostalCode 
© customerCreditLimit 





customerCountry: CHARACTER: CA 
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__25. Right click the wire between the CheckCountry node and the LAB.CANADA.OUT node. 


__26. Select Add Breakpoint from the menu. 
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__27. Select the Step Over button along the actions menu panel to run the Route node logic. 
Alternatively, you can press F6 to step over. 
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__28. Verify that the Route node has sent the message down the Canada terminal. 


2: B——- 


mre fcrren=) 








__29. Select Resume or Step Over to finish the flow (or press F8 or F6, respectively). 
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You can now re-run the test without overriding the customerCountry element in order to validate the path 
to the LAB.US.OUT queue. Return to the Integration Development perspective and the Test Client, and 
“Re-run’ the last Invoke Message Flow. 


_30. 


When finished testing the debugger (the debugger should be in a terminated state), right click 
the Debug perspective. 
_31. 


Select Close from the menu. 
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3.4 Accloser look at the deployment process 


Up to this point, we have been using the Test Client to initiate our unit testing and it has been handling 
the deployment process for us “under the covers.” To finish this lab, we will briefly examine the 
deployment process and manually do our own deployment. 


Key idea: The deployment process 


When you create application resources such as message flows in the IBM Integration Toolkit, you must 
distribute them to the nodes on which you want them to run. Data for message flows and associated 
resources is packaged in a broker archive, or BAR, file before being sent to the node. 


You can initiate a deployment in the following ways: 


From the IBM Integration Toolkit 

From the Integration Explorer 

By using the mqsideploy command 

By using functions defined by the Integration Bus CMP API 


Depending on your work patterns, you might use all these methods at different times. 


The Integration Toolkit provides a Nodes view in the lower left-hand corner of the Integration 
Development perspective. If you expand an integration node, all the integration servers in that node are 
displayed, as well as deployed message flows and their associated resources. You can drag an 
Application or Library, message flow, or a BAR file from the Application Development view onto an 
‘execution group to deploy it. Alternatively, you can right-click on an execution group to select an 
Application or Library, message flow, or BAR file to deploy to the selected execution group. 


I you are working with an application and want to deploy and test it quickly, you can deploy just that 
resource. Drag the resource onto the execution group to which you want to deploy it. A BAR file is 
generated automatically, and deployed to the node. If libraries are referenced, they are added 
automatically to the BAR file and deployed. If a message flow contains a subflow that is defined in a 
“subflow” file, the subflow is automatically included in the BAR file, and deployed with the message flow. 
It you drag a flow that is contained in an Application or Library, you will see a message saying that the 
whole application or library will be deployed, because you cannot deploy a message flow on its own if it 
belongs to an Application or Library. 


Key idea: The BAR file 


The unit of deployment to a broker is a BAR file. It is a .zip file that contains the flows, models, ar files, 
maps, and any other resources in the workspace needed to run applications. The BAR file also contains 
a deployment descriptor .xmi file, which exposes flow and node properties for override at build or deploy 
time. The following sequence of events illustrates how to deploy with a BAR file: 
1. Create a broker archive. 
2. Add files to the broker archive. 
3. If necessary, edit the configurable properties of the message flows or applications in the broker 
archive. 
4. Deploy the BAR file by sending it to the broker, from where its contents are distributed to the 
integration servers. 
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ABAR file can be deployed in two ways: 


+ Incremental BAR file deployment. Deployed files are added to the execution group. Files that 


exist in the execution group are replaced by the new version. 


+ Complete BAR file deployment. Files that are already deployed to the execution group are 
removed before the entire contents of the BAR file are deployed. Therefore, nothing is left in the 


execution group from previous deployments. 


__1, Return to the Integration Development perspective in the toolkit. 


__2. Select a blank area in the Navigation view on the left. 
__3. Press the right mouse button. 


_4. Select New>>BAR file from the menu. 
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__5. Enter Lab3 as the name of the new broker archive file. 


6. Select Finish. 


formes a 


Create a new BAR file 


i. G 


Container: | BARfiles 
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Name: 
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Inthe BAR editor, select the IntroLab Application. 





8. Click the Build and Save... button. 
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__9. If prompted to Save, click Yes. 


[ee ox 








OS) Gee Simin Satire 








10. Press the OK button. 


‘Adding to Broker Archive File 





e Operation completed successfully. 
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__11, Inthe BAR editor, select the Manage tab. 


__12, Expand the IntroLab app and select the various resources. 


IBM Software 


__13. Look at the Properties view below to see what properties are exposed in order to be overridden 
within the BAR file. For example, select the LAB.US.OUT node. You can see that the Queue 
Name property can be overridden at deployment time. 
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__14, To deploy, find the Lab3.bar file in the navigator in the BARS container. 


__15, Drag it onto the default integration server of the IBSNODE. 


‘Application Development New. 


Bi tnvolab 

[Al MQ Service 

BA IntroLablib 

BA MQ Service library 


Gh Bag 





__16. Once deployment is complete, click the default integration server to open it and see the assets 


deployed to it. The IntroLab application has been deployed, which included the 


Intro_MessageFlow message flow and the library that was included, which contains the 
IN_Request XML Schema, 


Data | Zi Task 





“2-iy Integration Nodes 
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BA IntroLabLib 
IN Request 





Finally, the Test Client will be updated to use this BAR rather than generating its own. 
17. Inthe editor, select the Test Client. 
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__18, Select the Configuration tab. 
19. Select the Deployment tab. 


__20. On the right inside the Specify Broker Archive box, select Browse. 
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__21. Inthe dialog box, select Lab3.bar. 
22, Click OK. 





‘Choosea resource: 





Pattern ? = any character, 








Matching Resources: 









IBSNODE_defautt.bar 
JKE AccountOpen.msgflow.generated.bar 


CEMEBBROKER defout.bar | 
(BMQ Service.bar 





In Folders: i 





(eS TestClientBarfiles 











@ ees | eer 
_23, wy... the Test Client. 


Frintrolab] 























BE IntroMessageFlow.msgflow 





aba, 





__24. Close all the open editor tabs but leave the toolkit running. 


This is the end of Lab 3. 
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Lab4 —_ Building a web service using patterns and mapping 


4.1 Lab overview 

In this lab, a web service fagade will be built on top of an existing IBM WebSphere MQ-based service. 
The Patterns Wizard will be used to build a message set and a set of message flows based on a Web 
Services Description Language (WSDL) definition file that is provided. Using a pattern will produce a 
solution that includes additional function but that requires less effort to create. 

The generated pattern will be extended by defining the mapping between the back-end service format 
(based on COBOL copy books) and the web service data format (based on the imported WSDL file). 
The message flow will be tested using the Test Client. 


The following is what will be built and tested. This is the main request flow. 








ak, piel 


SoAPtelk\ alse SerdFst\ ct SOAP oy, AU Het Write Requle jose 
{ 





aera -<fgp—$ro 
\saWebgehateha 
ims 

|aue \ 
Web Sees, \ \ | | 
gsca \ | | \ 
 Weasphte apes \ | \ | 

















(cco anne 
Srp Use Deine ropes] 





This is the main response flow. 





—al ge sone fe 


Recover epi SetUpFor Reply Add Reply Header sope Reply 





Groh er Dafne Proper 
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__1. If necessary, close any open editor views. You should see the Quick Starts wizards list. 


__2. Click Start from patterns in the list of Quick Starts. 





Tramiel] = 









Bint 
Bhiasesee 
ensntin 

i aseecc tay 
hae 

pnd Renae 





owt Wom Atak Sie 2 





The Patterns Explorer opens in the Navigator. 


Quick starts 
Seng or aon thon efoto ke 


1 sustacetinaen anon 


oper sce te anette ees 
wast ae 


(an cesgan eaten 


eaten erm pton th nd ec 








ecnoe cura srconce aR 


1 sacbcteaainancnie 


Schingeconmon iene Sey arene fey 


(S sictemone 


‘Use pls tame aba hen BM nga 
raters 


__4. Select the MQ request-response pattern under Service Enablement->Service Facade. 





Patterns 


4 (EE Patterns) 
Application Integration 
File Processing 
Healthcare 
Message-based Integration 
Microsoft. NET Integration 
Mobile 
4 Service Enablement 
4 Gif Service Access 
8B -MQ one-way 
4 (i Service Facade 








«4 GBF Service Proxy 





88 Static endpoint 
Static endpoint (web based) 
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__5. Take some time to read about the pattern and the solution it will generate. 


icra ; 


Service Facade to WebSphere MQ: request-response pattern 








‘Seas ge stween ts synanavs HiT oc, wher sake oaed wih wel sees, nd extn nBpcatons wit Wetaphes A meres ot nae eo be 
ss r : 


Use hs ptm whee oir pcos moe on inet a cet appleations spr cls to we sve, Th pte cn end wth transe tosuo 2 
alltel a tm res oe Wess 





‘he soon te nlement a esos fw hat provides service ety pit When 9 eng rau eee he el ete tcl nara a the 
See eae er Bt ns ets tam he peer cnn ep strc hoy 








__6. _ Click the Create New Instance button to start the Pattern Generation wizard. 





#5 View Pattern Specification 
‘vba ifematenatcu the caketod prom ard then sckth "rane ov Ietanes” btn oy ct ar start uerg a pator, 





Requesting 
‘Application 









‘Service Facade to WebSphere MO Provider 
‘ecjuestreaponse Application 

















> Ser 1S mp 


ae 





























Ges) 
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__7. Enter OpenAcct_SOAP as the Pattern instance name. 











_8. Click OK. 
© New aternictene | = 7 . EES 
Create New Instance Bo 


“The instance name uriquclyidendfies the pattem instance project thats cestedwhen the pattem imtanceis El 
saved or genersted, The name ideally reflects the business and integration functions thatthe pattem supports. 








Pattern instance name: 





@ 


























Expand the Service Information section under Pattern Parameters. This section is marked 
with an exception, indicating a required parameter. Also expand the Service Information 
section under Pattern Parameters Details to see help for each parameter. 





__10. Click Browse to the right of the Service WSDL input. 





(Siremrceereer —(ermaetanentteatee tsi 
Configure Patter Parameters 
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A selection dialog is shown. 


_11. Click the Import/Create New link. 


WSDL! 


IBM Software 








Filter names (? = any character 








Select a WSDL file 











Physical Location 








OK 
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A library will be created to import the WSDL into. 


__12. Click New... to the right of Application or Library 





[Over nessge Daten le we nl 





Create a new message model from a WSDL definition 
|) Select an application or brary from the list 








ieee 








Folder 








XML Schema file: 


(© Select file from workspace: 





Independent Resources 








© Select file fem outside workspace: 





Location 


= |[soe 











@® cel 


Finich 


Cancel 








13. Select the radio button for Library. 
14, Click OK. 


Doeememe 


Choose which container to create 
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__15. Enter OpenAcct_SOAP_Library for Library name. 
_16. Click Finish. 








Create a new library 








Libray name 

















@ = 
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__17. Expand Independent Resources->LabMaterials->WSDL. 
__18. Select the WSDL_ServerService.wsdl resource. 


19. Press the Next button. 


Ce a 


















































Create a new message model from a WSDL definition 
|| sezcthe soto crete the message made! and ansppietion riba prjetto contin || 
perenne 
Appttion co ion | aeameansimittaaas a eae 
fer cee 
XML Schema file: WSDL ServerServicexsd 
CC en 
@ @ Independent Resources 
1 1 LabMaterals 
4 @& WSDL 
© Set fe ontee wedopace 
Teeter ~] [Browse 
| 
® <Back | 


























Page 106 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


A WSDL may have multiple bindings. In this case there is only one. 
20. Click Finish. 


__21. Wait for the wizard to complete. 


| @ New: tic ail 





IBM Software 





Create a new message definition file from a WSDL definition 
|| Select SOAP and HTTP kindings for which physical format information will be generated. 





Select the WSDL bindings to import: 











[b) WSDL. ServerServiceivsdl] 
(2 BulldWSDL_ ServerSOAP HTTP Binding (Por type: BuildWSDL.ServerPortType) 
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When the wizard finishes several things have been done. A Library has been created 
(OpenAcct_SOAP_Library). The library contains schema definitions for all of the possible inputs to and 
outputs from the web service that are defined in the WSDL file, including the inclusion of the built-in 


SOAP schemas. 


__22 Highlight the WSDL_ServerService.wsdl in the new OpenAcct_SOAP_Library. 


23. Click OK. 


Filter names (? = any character, 











Select a WSDL file 











Physical Location 


Library: A OpenAcct SOAP_Library 
Path / 





@ Import/Creste New 


| @ 














__24. The Import Wizard also opened the WSDL. ServerService.xsd schema. Click the X to close the 


schema view. 





|(Pii pattem specification 
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__25. The OpenAcct_SOAP — Pattern Configuration window should be visible. The Service WSDL 


parameter is now complete. 





5 Configure Pati Para 


hth en pd ee in pd en 














__26, Collapse the Service information section. 


__27. Expand the Provider Information section. 


names are case-sensitive). 








__28, Change the Provider request queue field to IN (be sure to use uppercase — recall that queue 





(Exewnsenen  (ecmenecmnmencrmenta 








Configure Pattern Parameters 


ee 


| Panrentencete 











parameter 
Viaspoaenienaton . 

Provider quoue 
Ta wy | manager 
rns = Provider request 
Vesna . a 


Deserption 


owtr apples ecaiarrauets om tha 
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__29. Expand the Response Information section. 
__30. Change the Response queue field to REPLY. 


__31. Change the Store queue field to STATE. 





(feseseren[areeeasomnenmonate i 





Configure Pattom Porernotors 











attarn parametar 


rewseres ce’ [a Response queue 


‘store queue 


Expy of store queue 
messages in tenths of a 








{Tore tre Mehb eas ws wat for radar 
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__32. Collapse the Provider information and Response information sections. 
__33. Expand the Logging section. 

__34, Select the Logging required check box. 

__35. Accept the default value for the Log queue (LOG). 





(SiPatemSetssin [Sten SOR: Colon 
"Configure Patter Parameters 











ny. he bet 


ey | = 





el a 





naman || parameter 

eran F | Logaing ‘he pattern paraneterdeteranes whether the patter stance 
l aaa ‘sales te Ste or agra 
l i a! IF ogging rogue is clare, the Lag euow erat rede 
(4 a 


__36. Collapse the Logging section. 
__37. Expand the Error Handling section. 


Basic error handling is included by default, There is nothing to change in this section. 





(ipaensoescnon [A meet mete Gn 
"% Gonflgure Pattern Parameters 

















one eC 
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_38, 
_39. 
_40. 


At. 


Collapse the Error Handling section. 
Expand the General section. 
Enter OpenAcet_in the Flow prefix field. Please note the trailing underscore! 


Enter ACCTOPEN. in the Queue prefix field. Please do not forget the period at the end of 
the prefix. 


Make sure that the entries are in the prefix fields. 


Click ‘Generate’ to build the pattern. 





il 




















Broker schema 
Flow prefix 
Flow suffix 
(Queue prefix 
Queue cuffoc 
Short description 


Long desciption 















































Specficaton |Centigurston| 
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I "iy Summary for patter instance Opentect_ 808 


errs Tale say tet SA en ew 








Eee Mow [Sinem 


When the wizard has completed, you will see the Summary for pattern instance OpenAcct_SOAP 
window, which provides a brief summary of the artifacts that have been created and some further tasks 
that must be completed, such as creation of the necessary queues. 


The wizard has created an Application project called OpenAcct_SOAP_Flows. This application 
contains two message flows, OpenAcct_Request and OpenAcct_Response, plus four sub flows used 
by these message flows, OpenAcct_RequestProcessor, OpenAcct_ResponseProcessor, 
OpenAcct_Error, and OpenAcct_Log. 


You also will see the OpenAcct_SOAP Pattern Instance in your Application Development view. Under 
the Pattern Configuration falder, you will see the OpenAcct_SOAP_configuration.xm| file, the saved 
pattern configuration, and the OpenAcct_SOAP_summary.htm! fle, the summary screen, that can be 
used for later reference or pattern regeneration. 
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The queues will now be created using MQ Explorer. The ACCTOPEN.|N queue already exists. It is used 
by the existing MQ-based account open service. In a real-life scenario itis likely that the existing service 
would be running on a different system, in which case a remote queue definition would have to be made 
on the system that the node runtime is running on. It is possible to modify the MQOutput node that is 
used to send the message to route the message directly to the remote system by specifying a queue 
manager name. It is a better practice to keep the location of remote applications external from the 
applications themselves, including message flows. 


__44, Switch to MQ Explorer. 


__45. If necessary, expand Queue Managers->IB9QMGR so that Queues is visible. 








TEM WebSphere MQ 
& Queue Managers 





act 
& Subscriptions 
& Channels 
& Telemetry 
& Listeners 
& Sevices 
& Process Definitions 
&, IBINODE 
& Namelists 
& Authentication Information 
& Communication Information 
& Security Policies 

© Queue Manager Clusters 

© JMS Administered Objects 
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__46. Select Queues. 
__A7. Press the right mouse button. 


__48, Select New>Local Queue from the menu, 








= 1) Gi MQ Explorer - Content | * Administration 
@E |) — Message Source v 


“+ @ BM Websphere MQ 
“4 & Queue Managers 








Alias Queue. 
Model Queue... 
Remote Queue Definition... 





__49. Enter ACCTOPEN.REPLY as the name of the new queue. 


__50. Press the Finish button to create the queue. 





Create a Local Queue 


Enter the details of the object you wish to create 





Name: 


ACCTOPEN.REPLY] 


Select an existing object from which to copy the atvibutes for thenew object. 





SYSTEM DEFAULT.LOCAL QUEUE 





When this weard completes, another wizard can be started automatically to create a matching object. 
(7) stare wizard to create matching JMS Queue 
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_5i. 


Press the OK button to dismiss the notification. 


ee 








i) The object was created successfully. (AMQUI48) 


[Ho not show success messages in future 
|| (To re-enable, go to the MQ Explorer preferences) 











_52. 


_53. 


_54, 


Repeat the previous three steps to create the following queues: 
ACCTOPEN.STATE 

ACCTOPEN.LOG 

ACCTOPEN.ERROR 


Minimize the MQ Explorer window. 


Return to the Integration Toolkit and close the OpenAcct_SOAP_summary and 
OpenAcct_SOAP - Pattern Configuration tabs. 





_56, 
_56, 


_57. 


Select the new OpenAcct_SOAP_Flows application. 
Press the right mouse button. 


Select Manage Library references from the menu. 








New » 


a) 


> Sl Manage included projec 
» [Bl OpenAcet SOAP Flovd 
14 BA OpenAcct SOAP Libra ©! Focus on Application 





> CS Schema Definitions Convert to Library 
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__58, Select the M@_Service_Library. 
_59. Click OK. 


@ Manage Library references =) 





Check the libraries to be referenced. Any other 
libraries referenced from the checked library 
will also be included. Leaving a library 
unchecked will prevent the libraries from being 
included. 














— SE TUAETSIan. 
ESS Seas aeees 
y they are referenced by the checked libraries y 
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_60. You will see that the MQ_Service_Library library has been added to the References. 


‘Application Development New, 


> EB Pattern Instances 
4 Bl OpenAcct SOAP Flows 
> EB Flows 
> 5 ESQls 
4 (By References 
> BA MQ Service Library 
> BA Opendect SOAP _Library 
4 Bil OpenAcct SOAP_Library 
> (3 Schema Definitions 
> (& WSDL Definitions 
> (© Other Resources 
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_61. Click the small triangular icon on the project navigator in the Application Development tab. 





__62. Select ‘Edit Active Working Set ...’ from the menu. 









Quick Starts 


‘Application Development Ne Select Working Set. 








> GB Pattern Instances 
4 i Opendcct SOAP Flows 
4 F2 Flows 
4 BB msi 


__63. Select the M@_Service_Library check box. Do not remove any selections. 





TB) 1 Openacct SOAP 


__64. Click Finish. 





Broker Working Set 





Entera working set nameand select the working set elements, 








Working set name: OpenAcct SOAP 
Working set content: 
(Automatically include dependent projects in this working set | 


CO Bearfles 

© wecustos 

Fy GB GeneratedBarFiles 
7 Bitntrotab 

© eiintroLablib 
DB LabMaterials 












lOpendcet SOAP Flows 
Bi Opendcct SOAP Library 
1G TestchentBarrites 











| eee [es 
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The response message flow needs to be configured for the message format sent by the MQ back-end 


service. 
__65. Expand OpenAcct_SOAP_Flows->Flows>mqsi 


__68. Double Click the OpenAcct_Response.msgflow. 





‘Application Development New, 








> GB Pattern Instances, 
4 {Bl Opendcct SOAP Flows 
4 PS Flows 
4 BB mast 
FU OpenAcet Enorzmsgflow 
1 Opendect Logmsatow 





eof SQLs 
2g Riserenies 
> Bh MQ Service Library 
» BA Opendcct. SOAP Library 
> BA MQ Service Library 
> Bh OpenAcct SOAP Library 





__67. Select the Get Response input node. 





o_o 














Jeveetetct Beenie. Rapesco ~= z 





identi soar 
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__68, Select the Input Message Parsing tab 


__69. Select DFDL for Message domain usin 


in the Properties view. 


9 the drop-down menu. 


__70. Press the Browse button next to Message. 


Een peti] hayes 











——— 
es 


__71. Select the ACCOUNTREQUEST{} message definition under MQ_Service_Library. 


__72. Press the OK button. 





DFDL Message Selection 


Select 2 message from a DFDL schema file in a Library or Application 





Filter message names (? = any character, * = any String): 





Select 2 message: 





“4B MQ Senice Library 
4 @ DFDL Schemas 





any 
«4 GS DFDLSchemar 
(fh In_Requesthttps//wwwbm.ab.com} 
(Out. Response (http/wonmibm.lab.com| 





Physicel Location: 





Library: BA MQ Service Library 
Path: & Accountxsd 
Namespace: {8 {} 











@ 
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__73. The message should now be visible in the node properties. 











(Fito. Pretender og] roges ew] 225 
18 MQ input Node Properties - Get Response 

Inet Mesape ari 

Pave Opsew | Mage demsin FL: For nay ctesmeaege vith «Sls Foret DecipbnLanguageschere model > 
ateeest Menogemoss [OPO 

alton —S—= x 

Secty Menese 
Jase “espana bbl schenaiefoineasimazee shen 

| Mereereg tetra a — J] 





_74, APEA cave tne tow (ctriss). 


__75. Close the Message Flow editor. 





Now you need to create the mappings between the web services message format and the MQ back-end 
service format. These mappings will be placed in the OpenAcct_RequestProcessor and 
OpenAcct_ResponseProcessor sub flows. 


__76. Double click the OpenAcct_RequestProcessor.msgflow message flow. 


Application Development Ne 





> Ej Pattern Instances 
4 Fl OpenAcct SOAP Flows 
a BB Flows 
4 BB asi 


OpenAcct Error.msgflow 





S| OpenAcct_ResponseProcessor.msgflow 
> EM ESQLs 
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77. Expand the Transformation drawer. 


__78. Drag a Mapping node from the palette directly on the connector between the Input node and the 
Passthrough node. 


__79. Drop the node when the connector color changes to blue. 


jes 








(fx Pacstough Output 





Gpyranetora 
compute 

@aavaconpute 
Gl rrrcomoiee 





‘The Mapping node should now have been connected with both existing nodes. 


_80. Change the name of the mapping node to SOAP2Cobol. 


bh ~—ol 


Tops | Passthrough Output 











SOAP2Catol 
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__82, Accept the default values for the map name and location. 


__83, Press the Next button to continue. 
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Specily a new message map file as 
Select mas ype container neme, and broke achema forthe new maa, =r 
‘ype of map that you want a crest: 
Mezzage map cles bya mazzage few node 
Submap called by anther map 
Contsner [GpenhcesSOAILFowe = 
Map name Bperdcet Requestrocess, SOAPZCabo| 
Map organization 
7 Use aefaut brakerscnema 
ey amas E 
|| Apoty werking et fitering to aac selections on hs page 
@ a ora 
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__84. Expand the OpenAcct_SOAP_Library->DFDL and XML Schemas folder in the map inputs. 
__85. Select In_Request as map input. 

_88. Expand the M@_Service_Library>DFDL and XML Schemas folder in the map outputs. 
__87. Select ACCOUNTREQUEST as map output. 

__88. Press the Next button to continue. 


ST at 


Select map inputs and outputs 





Cramer z map that can contain mezsage inputs and ouput with the Prepati: flder. Optonaly, databace operations, mezsage 
hesclers and LocalEmdiranmert can be added to the map afer cestion, 








Filter mep input neres (= eny characte, * = any Sting) Fiter map output nemes 
select map ingute Select map outpute 
[S-DFDL and XML Schemae E 





[EB Body ftp /schemasamlscep 01g/209p/envelope/ 
[ED Envelope thmp,//echemas mlzoap.crg/soap/enveloy 
[7 Fault (etpu/schemasserlsoap.cre/seap/ervelope/) 












age mele 


| nysicat Location: 

Libray: mh MQ Service Library 
Path: > Accountxsd 
Namespace 0 








® so] (a) | ae 
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89. Confirm that the Output domain is set to DFDL. 


__90. Press the Finish button to create the map. 










‘Soloct the domain to create the output 







Sethe output domein ef main map called by message few node ==F 








(Output domains [BEDE 


ve 














ere 


Goneel 























The Mapping editor will open. 


__91. Drag the _In_Request source to the ACCOUNTREQUEST target. 





[E Opentec Requetbrocesor SOAP2Catel 





penhct. RepestPrvesnt SOAPIobot Pe x PS ThE S 
15 et Mestage Asvernbly In Request | [of Message Assembly -ACCOUNTREQUEST 
Ye eCickto ate He Chickto far 

$B Propetine (04) Propetistype 








Bl Propeiee Io. Popeye 


_—- 
i 






iw gIACCOUNTREQUEST [1] ACCOUNTREQUEST | 





EB Request ‘al In Paquet 


The source and target are complex structures. A local mapping operation will be generated. 


_92. Click the Local map link. 





BE OpenAcct Requesrocssor SOAPZCobel 





Opener equetrocenor SONP2Csbal ee | x) 8) SR Soe) 


tries ceriy aig any ACCOR 
H sche Scotter» 
2 hopetic BL opaticTive 


+B BIACCOUNTREGUEST Ba) ACCOUNTREGUEST 













(0.3) Propeiestype 





win Request OA InRequest 
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The local map will open, 


__93, Select the auto map icon to start an auto map operation. 





TB Opencct RequetProcsso, SOAD2Cobol > H) ACCOUNTREQUEST 














Openhcct RequesProeaer SOM | PO] BhEae B 
g 
[= Blin Request InFequer: (3 & ACCOUNTREQUEST |ACCOUNTREQUES 
FP <Chckto filter.» FP <Chickte filter.» 
Tasonettnter Wal aay (SACTONLAEQUET aT Ong 
Tiestenename ll dong BOAT mQUsT (ll «PX stp 
Ti catenedeale Hl «Anonymous ‘e|CUSTONER ACCOUNT UNRER —B-Al_<PEX stage 
we Beowatenis all <Anonjmous TBCUSTONER-COMPANY-RAME LA] <PCX sng» 
iiDatctevet Ball sting 3s CUSIOMR OETA Ball eteonprous 
leonmens all ang is CONTACT. FRSA Til OO sng 
BLconTACt Last nave (Ll «PX stp 
Te CONTACT PHONE a Ig 
conwes ll «PEA singe 
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_94, 


_95. 


_36, 


_97. 











‘Automatically map inputs to outputs 


Chars the options te sutoratialy map the sete inp and out element. 
Glee Ned ofl the arto to Gere ck Fh fo ciate tviormsfor althematcng lent = 
1 Mop a sinple descends ofthe selected ements 


© Map thebmediateciden of the lcd elements 


| ameWatching Options 
Pico 


lphanumeric hates (betas and aigtr ond) 


Mapping Cerin 
Pr lor moreinferaton when theame of np nel udpts aly mere than ere ceo 
Wicratetvrsforms when thename fing ne output rethesame 
Wicrate van 


[Ticratearsforrswhen the ing er out names are mashed eyneryn eine in fe 





IBM Software 
Select the check box for Create mappings when source and target names are more similar 
than. 
Set the % match to 50 using the slider bar or by overtyping the value. 
Uncheck the box for alphanumeric characters. 


Click Next. 


croup zanstonns ino nested mage 








when the names efinpus and outs we more simran 


; a Dn Po 















































‘A.comparison of the names will be performed and the results shown on the next screen. 
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In this case the CUSTOMER_ACCOUNT_NUMBER target has two sources. This is not right. It will now 


be corrected. 


_98. Select the line with two sources (CUSTOMER_ACCOUNT_NUMBER). 


__99. Click the Edit button. 





Solect wanstorms to erento 





‘ee Ea, orsoubie sek he rou 


int and ouput denen at satis the prevouly chosen options alte. Te deselect an output clits check box To dene an ints om 





= 








found 





Trerferm Outputs 
2 BIG Mezaye Asemnly 
a [vl ACCOUNTREQUEST 
"lel ConawenTs 
(CONTACT. PAST NAME 





| 4 IIB] custower oeras 
[uc ADDRESS 
(Pi) ADDRES 
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_100. Uncheck the box for customerCountry as this is not the proper source for this target. 


__101. Click OK to remove the incorrect mapping. 


Tia _ ssa 


Transform Inputs: 


| Calle] customerCountry (Message Assembly/ juest/customerDetails| 
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‘The CUSTOMER_ACCOUNT_NUMBER target field now has a single correct source. 


__102. Click the Finish button to perform the auto map function. 





Sole imnetorms to erent 
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There are some required fields not mapped automatically so you need to add them now. 


__103. Use drag to map the source customerCiy field to the target CITY field. 





__104. Map the source customerCountry field dragging it onto the target COUNTRY field. 
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105. Right-click the DECISION field in the target half. 
_108. Select Create Assign from the menu. 


Saat > CTE 


Ilasimecemey al =p 
BaterePotane Ha 


lsstoneGetibet Hal 


lawtoreicor tll 


Sl onacesi Ba 
lestasintre tall 
Geencistene 1 
eotcthentimbe al 
Hoste at 


ennase nar 





__107. With the new Assign map selected go to the Properties tab. 
__108. Select the General tab. 


__109. Enter a single character Y as the Value for this assignment. The letter should be upper case. 





Cardinalty 


__110. Right click the ACTION_REQUEST field in the target halt 


__111. Select Create Assign from the menu. 


__112. With the new Assign map selected go to the Properties tab. 
__113. In the Properties pane select the General tab. 


__114. Enter a single character (letter) O as the value for this assignment. The letter should be upper 
case. 


Si? 





Transform - Assign 
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Now it is time to address the two warnings within the generated map. 


__115. Locate the Move map for the customerCreditLimit. Hover over the warming symbol (a small 
yellow triangle containing an exclamation mark) to reveal the details of the warning. The warning 
text is: The string simple type input does not match the <PICS9-Comp3_int> simple type 
output. Use a Convert transform to ensure proper conversion. 





name tal a = 
ewcnety ttl i 
lamer ntl are Cn 
eck ntl he SS 
Damon stl ore aoe 

a a iseeaaen 


Blortrraiee tll are 


Weristatiee Ut are 





__116. Move the cursor to hover over the light bulb (just next to the warning symbol). 


__117. Select the quick fix that is being offered: Use convert to ensure the proper conversion. 














Repeat this process to resolve the remaining warning in the map. 
__118. Locate the Move map for the customerCreditScore. 
__119. Once again move the cursor to hover over the light bulb (just next to the warning symbol). 


__120. Select the quick fix that is being offered: Use convert to ensure the proper conversion 











The local map is now complete. 
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__121. Return to the top-level map by clicking the upward yellow arrow. 





B OpencetRequesrocesor SOAP2Cobo! > ej ACCOUNTREQUEST 
bel [PP x = 8 Gish aa & 












ECSU 
Le coickto ier > | 





There is one more consideration for the map to be complete. The input message arrives over an HTTP 
transport. The output message will be sent over WebSphere MQ The input message will contain an 
HTTP input header, which should be removed before sending the message to MQ. The removal of the 
HTTP header could also be accomplished using an HTTPHeader node. However, in this case the 
mapping node will be used to remove the header. This is accomplished by adding the header on the 
target side of the map but not mapping anything to it. 


The MQMD header will then be added by the MQ Qutput node as this puts a message to the queue. 
__122. In the output Message Assembly select the small blue “i” symbol to the right. 


__123, Click the Header: Properties link. 

































[= [53 Message Assembly “ACCOUNTREQUEST | |) 3 Me i % 
3b <Cick to fitter.» 
el Qutput domain DEOL 
@ Properties 10.11] PropertesType See 
icader Properties 
“|B sRIACCOUNTREQUEST | [1.1] | ACCOUNTREQUEST TCCOUNTREQUEST 





Type: {ACCOUNTREQUEST 
Open schema 
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__124. Expand the HTTP Headers folder (Do not select all the headers at this level). 
__125. Select the check box next to the HTTPInputHeader header. 


__126, Press the OK button to add the header. 


Pi tcrten e aa) 











[No folders (map body element only) 
Selected headers and other folders 














[Hillel Localénvironment] 
Ej Properties 
> EG MQHesders 
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[Eel HTTPRequestHeader 
[FEE] HTTPResponseHeader 
[LE JMstransport 
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The HTTPinputHeader is now shown in both the graphical map (shown here with the target properties 
minimized) and the Headers and folders property. Since nothing is mapped to this header it will be 
deleted from the map output. 


TB OpendcctRequesProcesioy SONKCObO 













‘~Openscct Requestrocener SOAPICato| 
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[Headers and folie: apenas HTTEaue 
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This finishes the request mapping. 


aly, i | Save the map (Ctrl+S). 


__ 128. Close the Map editor. 
129, RPA nave no OpenAcct_RequestProcessor message flow (Ctrl+S). 


__180. Close the OpenAcct_RequestProcessor message flow editor tab. 
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__131. Double-click the OpenAcct_ResponseProcessor.msgflow message flow. 


Application Development Ne 








Gy Pate Instances 
Bl OpenAcct_ SOAP_Flows 
EE Flows 
B mast 
15 OpenAcet_Errormagflow 
Opendect Logmsgflow 
(8 Opendcct Request msgfiow 
Bal OpenAcct_RequestProcessor.msgflow 





(2 Maps| 


__132. Expand the Transformation folder. 


__133. Drag a Mapping node from the palette directly on the connector between the Input node and the 


Passthrough node. 


__134. Drop the node when the connector color changes to blue. 











(ng WebSphere MQ. 


(Web Services 





(Gb WebSphere Adapters 
(Routing 
as 










@avaCompute 
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Passthrough Output 
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The mapping nade should now be connected with both existing nodes. 


__135. Change the name of the mapping node to Cobol2SOAP. 


I lr 
afl 
| 


Input Passthroush Output 


















__137. Accept the default values for the map name and location. 


__138. Press the Next button to continue. 
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__199. In the left hand pane, expand the MQ_Service_Library>DFDL and XML Schemas folders. 


__140. Check the box next to ACCOUNTREQUEST. This will be the input message for the mapping. 


__141. In the right hand pane, expand the OpenAcct_SOAP_Library->DFDL and XML Schemas 


folders. 


__142. Check the box next to Out_Response. This will be the output message for the mapping. 


143. Click Next. 


Si] 
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The output message will be the reply to the web service in SOAP XML. 


144. Leave XMLNSC selected as the Output domain. 


__145. Click Finish. 
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A local mapping operation will be created. 


__147. Click the Local map operation. 
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Expand the source and target message bodies. 
__148. Create assignments by dragging: 
__a. DATE_REQUEST to DateRequest 
__b. CUSTOMER_ACCOUNT_NUMBER to customerNumber 
__c. CUSTOMER_COMPANY_NAME to customerName 
__d. DECISION to requestDecision 
__e. COMMENTS to message 





[E> Openkcct RepornePecener CabelSOAP > (Ou sponte 
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This finishes the response mapping. 


__149. Click the yellow up arrow to return to the top level map. 





[B Openrcct Reponeehocezr CoboRSOAP > Hy Out Response 
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150. PF save ne map (Ctrl+S). 
__151. Close the Map editor. 
152. A caro ne OpenAcct_ResponseProcessor message flow (Ctrl+S). 


__153. Close the OpenAcct_ResponseProcessor message flow. 
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4.2 Test the message flow 

The Test Client can be used to test flows that begin with MQInput, HTTPInput, JMSInput, SCAlnput or 
‘SOAPInput nodes. The Test Client will automate much of that process for us. It will create and populate 
a BAR file, deploy the BAR file to the integration server, submit a test message, monitor any output 
nodes for results and display the results. 


The message flow depends on a message flow in the MQ_Service application. This message flow 
simulates a back end account open service based on MQ. This application will be deployed first. 


__1, Select the small triangle on the right near the top of the project navigator. 


__2. Select Edit Active Working Set from the menu. 








Application Development Ne Select Working Set 


> Bj Pattem Instances 


44 [Bl Opendcct SOAP Flows Eclt Active Working Set 


7 & as FE) 1 Opendcct SOAP 
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__3. Select the check box next to the CUSTDB project. 
__4, Select the check box next to the M@_Service project. 


__5. Press the Finish button. 





Broker Working Set P 
Entera working set name and selectthe working set elements. 





Working set name: OpenAcct_ SOAP 
Working set content: 





\utomatically include dependent projects in this working set 
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0S TestClientBarFiles 
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_6. Drag the MQ_Service application to the default integration server. 












2 OpenAcct_Error.msgflow 
92 Opendtect_Legamegflow 
72 OpenAcct_Request.msgflow B 
FS OpenAcct RequestProcessor.msgflow 

[95 OpenAcct Response.msgflow 

[28 OpenAcct ResponseProcessor.msgflow 

















A deployment operation will start. 
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i} Deploying [MQ Service] to execution group [defeult] 
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‘The MQ_Service application should be visible under the default integration server. 








BE Outline (3 Data So |Z) Tasks Sasi 








“2: Wig Integration Nodes 
4 @ IBSNODE 
> O% Configurable Sevices 


4% default] 
> il introLab 
» BI MQ Service 
7. Select the OpenAcct_Request message flow. 
8. _ Hold down the Ctrl key and select the OpenAcct_Response message flow. 


9. Press the right mouse button. 


__10. Select Test Message Flow from the context menu. This starts the Test Client. 
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__11, Press the OK button to dismiss the warning. 


a 


“The meszage flow 'OpenAcct Request megflow'is owned by an Application ora 
Library end can net be depleyed individually. The owning Application or Library will 
be deployed instead. Do you want to continue? 
































__12, Use the Body pull-down menu to select the Edit as text option. 
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__13. If a warning is displayed press the Yes button. This warning will not appear if the check box was 
selected in an earlier lab. 


Omoman! Ga 


i Data in the original editor may be lost when switching to another editor. Continue? 









De nat chow warning when switching between XMLetructure editor and:ource editor 
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_14. Click the Import Source button. 
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__15. Navigate to the C:\student\SOAP_InputMessages directory. 
16, Select the Account_Open_Request.xm! file. 
17. Click the Open button. 


















© oper a 
———————— ee ——= 
Local Disk (G) > student > SOAPInputMesages] | #4 || Search SOAP Inputlfessages 
Organize ~ New folder >  @ 
ws * Name “5 Date modified Type 
HB Desktop 7/8/2013 1140 AM XML Document 
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Hl Recent Places “Account-Update Request 7/8/2013.14:10 AM XML Document. 
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od Music 

Pictures 
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Filename: Account_Open Request 
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19. Select MQ Settings. 





[continration 


Riera oer 





at. 








20. Remove the selection from the Stop when the first MQ message is received check box. 


Change the Select purge or browse option to ‘Browse message from MQ output queue’. 
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Pi ail 
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22. Switch back to the Events tab. 
23. Press the Send Message button to initiate the test. 
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__24. Highlight the default integration server. 
__25. Click Next (this time only). 














Specify deplayment details 


This server instance is currently running. 





Deployment location: 


«2 Ei Integration Bus v90 
1 Gi IONODE 








New Local Integration Node»: 


as 

















Trece and debug 
[step at the beginning of the flow during debugging 





Always use the same deployment location for every test run 











® | | 
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__26, Verify that you have a value of 40 as the Seconds to wait for deployment completion and 
Seconds to wait on launching the debugger for tracing purpose fields. 

__27. Enter 120 as the Seconds to wait for test client to stop. 

__28. Make sure the Add or modify ... check box is checked 

_28. Click Finish. 

(© set oopomeninaiss 


Specify Test Settings 
Determine the settings of the test environment, 











Sanuctindyaet 6 
Sarria: O | 
See oetnancrste eee treeenrerer| © 
[F) Show information dialog before disconnecting debugger. 


Seconds to waitfor test client to stop 














_30. Press the Yes button to continue. 








The selected flows can not be added to the BAR file without compilation. Do you 
went to add the flows tothe BAR file as CMF? Te avoid this dialog yeu can deselect a 
workspace preference ‘Deploy flow resources without compiling for automatically 
generated BAR files' Set the preference using Window-> Peferences-> Broker 
Development-> Build Broke: Archive' panel. 











ae | 
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The Test Client should start. A progress screen shows the test client deploying the message flows and 
associated artifacts. The progress of these actions is detailed in the Troubleshooting log. 
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__31. When the response is received, itis displayed. 


Message Flow Test Events » 


bales eleaR = 
EF Invoke Message Flow I 
Message flows deployment successfully completed 
Wp Stating 


1 Sending Message to "SOAP Input" 
Ng MQ Queue Monitor "ACCTOPEN.LOG" 








@ MQ Queue Moniter "ACCTOPEN.STATE" 
2 Received HTTP reply message for SOAP Input™ 
#2. MQ Queue Monitor "ACCTOPEN.LOG" 
© Timeout 
Ej, Stopped listening for response 
B Stopped 
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__32, Select the Received HTTP reply message for “SOAP Input” line. 


Menage Flaw Test vents + oneal Properties 
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ET IncleMesageFow 


“Y Wessage oun deployment succes completed 








Endpoint URL: H/o T30/Sene 


ee 
2 Ve Sating om 
2 Senin Message to "SOAP input” 








vue 
NsLEmeope 
‘nla tt tp /schemassrtoupor/sep/enelepe) 
NSLBedy 
1 Stooed nening for esponee outOut Feegonse 


1 Stopped 


requesDeciscn 
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33. If necessary use the small blue box icon to stop the test. 
34. Close the Test Client. 


_35. Select Yes to save the test. The same test can be used again later without needing to rebuild it. 





‘@ swenonwee TTT 


| 





@ “OpenAcct SOAP Flows.mbtest has been modified. Save changes? 
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The ability to save multiple configurations and messages can be used to build a “test suite.” This could 


be used for regression testing in the future, for example. 
_36. Highlight the OpenAcct_SOAP_Flows project. 


__37. Click Finish to save the Test Client configuration, 





Save Execution Trace 





Save the execution trace nd al test configurations of 
Opentect SOAP Flows.mbtestin afi. 
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1B TestClientBarFiles 


Filename: OpenAcct SOAP Flowsmbtest 
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This is the end of Lab 4. 
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Lab5 Using .NET in IBM Integration Bus 


5.1 Overview 


This lab will provide an introduction to using the NET compute node in IBM Integration Bus Version 9. 
This lab will use the .NET compute node sample. The sample filters, modifies, and transforms messages 
using code written in G#. The NET compute node can be used to construct output messages and 
interact with the Microsoft .NET framework (.NET) or Component Object Model (COM) applications. 


IBM Integration Bus enables the hosting and execution of NET code inside of an integration server. The 
.NET compute node routes or transforms messages using any Common Language Runtime (CLR) 
compliant NET programming language, including C#, Visual Basic (VB), F# or C++/Common Language 
Infrastructure (CLI). The implementation uses V4.5 of the Microsoft NET Framework. 


Microsoft Visual Studio Express edition is installed; if another version of Microsoft Visual Studio is 
available then that can be used instead. 


5.2 Install the sample 


__1. Inthe integration toolkit select File->Switch Workspace->Other. 


Edt Navigate Search 





New AleShiten + Se 
Open File. 
Close tote 
lose A triste W 
sn cts 
saveall coe shite+s 
Revet 
Renarne: R 
2) Refresh S 
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_2. Select the C:\student\dotNet\workspace workspace (the Browse button can be used). 


__3. Press the OK button to continue. 





© Workspace Launcher —— Itieel 





Soloct a workspace 


‘Websphere Message Broker Toolkit- Messege Broker stores your projects in a folder called a workspace. 
Choose 2 workspace folder to use fer this seston. 
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» Copy Settings 








‘A Welcome screen is displayed. 


__4. Click the Samples hot spot. (If the Welcome screen is not displayed, select Help>Welcome.) 
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Close the Welcome tab. 
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Scroll down so that the Message Transformation category is visible. 





7. Expand the Message Transformation category. 





Click the .Net Compute Node sample. 
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9. The sample preparation wizard should launch. Click on Import the sample (not Import and 














Deploy the sample). 
ein Gaus =Snleaet 
SE nmanmenmaee 
Seer mail .NETCompute Node sample 
ne aca wdenae that shows how a message fan 
2 urguee 
= B Wrens Menane rer Yori 8R04 YS eeog ae NETCompul nes ablation Wows ol Te nad ns asses hat a8 

= Srwmacnnes Blithe Mae tet oon tang Free You coe 


aWeammen 

















Hoth NETCime mode is ud mesg a cnt 
{Hops NET Faron esr canbe yet ka 








+ fund det th cama 
“iv pon wr th erp sim or pce oposite be 
ep edtonal wrouces rt reso exap, tnsphe WO 
ce Ms dso sana te een 









10. Press the Next button. 
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11. Make sure that all the tasks were completed successfully. 
12. Press the Next button. 


or 
‘Sample Imported successfully 
cherie casera 
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__14, Control should return to the Information Center. Expand the NET Compute Node entry. 


__15. Select the Cit code for the sample item. 


16. Examine the C# code for the nodes in the sample. There is further information available about 
the sample by clicking on the other items. 
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__17. After examining the sample documentation close the Information Genter. 
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__18, Return to the integration toolkit. 


The sample has created a message flow in an application named DotNetApplication. The flow uses a 
library with a message model for a comma separated message format (CommaSeparatedF ormat.xsd). 
‘Two message flow test cases and a broker archive are provided to test and deploy the message flow. 


The message flow uses three .NET compute nodes. The first node (Filter) checks the input message 
format and routes the message to the correct path through the flow. The second node (Modify) adds 
some XML elements to the message and sends it to the loyalty application for processing. The third node 
(Create) transforms the input message into a new output message, which uses a comma separated 
variables (CSV) format. In both cases the output messages will be sent to the DOTNET.OUT queue. The 
loyalty path uses an MQ output node with the queue name specified in the node properties. The Create 
node creates a destination list with an entry for the DOTNET.OUT queue. 
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5.3 Create the .NET classes 
1, Select the NET compute node labeled Filter. 
2, Press the right mouse button. 


3. Select Open Microsoft Visual Studio from the menu. 









Undo CtrleZ 
Redo Ciley 


Create Connection 
Create Cloned Node. 
‘Add Output Terminal 
Remove Output Terminal 


Rename Output Terminal 





Cut Ctrlex 


Visual Studio Express should start. 
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__4. Click on New Project... 
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Select IBM Integration, 
6. _ Select the Filter an IBM Integration message template 
7. _ Enter SampleintegrationProject as the Name. 


8. Press the OK button, 
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The project should now be created. The G# editor should open with a skeleton program. The program 
(FilterNode.cs) should be visible in the Solution Explorer in the upper right. 















9. Replace the contents of the Evaluate method with the code available in a text file called 
FilterNode.cs in the C:\student\dotNET\resources directory. 
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__10. Copy the code from FilterNode.cs.txt text file replacing the evaluate method in the template. 





pibLie class Filcertous 1 ECompueenode 














spputiecenble! 


toneseage toptunaaage 7 stpwcisoeabig tenses 


{1 change che toLlowang 1 nor peoyognrane message ta the Scie 
cueTerminal.Peopagate (Input aseen1) + 








Page 166 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


IBM Software 


oi RP corene updated program (Ctrl+S). 
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Use the Solution Explorer to add another Class to the SampleintegrationProject project. 
__12, In the Solution Explorer select the SampleintegrationProject project. 


__13, Press the right mouse button. 


__14, Select Add->Class from the menu. 
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__15, Select IBM Integration, 


__16. Select the Modify an IBM Integration message template. 


__17. Change the Name to ModifyNode.cs. 
__18, Press the Add button. 
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A sskeleton module is created. 


19. Expand the UserCode area by clicking the small plus sign. 


























20. Replace the contents of the UserCode region with the code available in a file called 
ModifyNode.cs.txt in the udent\dotNET\resources directory. 
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Replace the highlighted code: 
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_2t RP corene updated program (Ctrl+S). 
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Use the Solution Explorer to add another Class to the SampleintegrationProject project. 
__22. Inthe Solution Explorer select the SampleintegrationProject project. 


__23. Press the right mouse button. 


__24. Select Add->Class from the menu. 
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_25. Select IBM Integration. 
__26. Select the Create an IBM Integration message template. 
_27. Change the Name to CreateNode.cs. 


__28, Press the Add button. 
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A skeleton module is created. 


__29. Expand the UserCode area by clicking the small plus sign. 
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30. Replace the contents of the UserCode region with the code below. This code is available in a file 
called CreateNode.cs in the C:\student\dotNET\resources directory. 
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Replace the highlighted code: 


[exo 
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__31. Insert the routine CreateNodeTransformMethod.cs above the CopyMessageHeaders region. 
This code is available in a file called CreateNodeTransformMethod.cs.txt in the 
C:\student\dotNET\esources directory. 
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Insert the code at the location pointed to by the arrow: 
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__32, RP corene updated program (Ctrl+S). 
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__33. Now In the Solution Explorer, select the SampleintegrationProject project. 


There should be three classes visible in the project. 











Page 178 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


___34. Inthe project menus, click File->Save SampleintegrationProject. 
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__35. In the Save Project dialog, take the defaults and click Save. 
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__36. In the project menus, select Debug->Windows-> Output. 
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Output Window: 











__37. Inthe Solution Explorer pane select the SampleintegrationProject project. 


__38, Press the right mouse button. 


__39. Select Build from the menu. 







rationProject' (project) 
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‘Add Service Reference.. 


The results of the build operation should be visible in the Output window. 
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__40. Close Visual Studio. 
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5.4 Create the configurable service 


Having built an assembly file from the C# code, it is possible to drag the assembly file from a Windows 
Explorer window directly onto a .NET compute node in the integration toolkit in order to associate the 
code with the node. This technique results in a hard-coded absolute file system location pointing to the 
assembly. It is useful when developing, testing and hot-swapping the .NET code that the node is 
‘executing. However, for production situations, a better approach is to define a configurable service that 
specifies the location of the assembly file. This method is more dynamic and better suited when moving a 
deployment between environments during development, test, and production. The diagram below shows 
that the same message flow can be used in multiple environments, with the configurable service defining 
the location of the assembly file, which might be at a different location for each environment. 
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Windows Explorer will be used to copy the assembly files to a known location. 


1. Navigate to the following directory. 








(Csusers'admin\My Documents\Visual Studio 2010\Projects\SamplelntegrationProject'SamplelntegrationProjectibin\Release 


2. Select the SampleintegrationProject.dil. 








Hold down Cir! and select the SampleintegrationProject. pdb files. 


Right click on one of the files. 





Select Copy from the menu, 
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8. _ Navigate to the C:\student\dotNET\assembly directory. 


__7. Press the right mouse button. 


8 Select Paste from the menu. 
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The two files should now be visible in the assembly directory. 





























__9. Close the Windows Explorer session. 
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__10. Switch to Integration (MQ) Explorer. 

__11. Expand Integration Nodes->IB9NODE. 

__12, Select Configurable Services under the IBSNODE node. 
13. Press the right mouse button. 


__14, Select New->Configurable Service. 


44 g Integration Nodes 











Page 184 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


IBM Software 


__15. Enter SampleDotNetConfigService as the Name. 


__16. Use the drop-down menu to select DotNetAppDomain as the Type. 





__17. Enter C:\student\dotNET\assembly as the ApplicationBase. 


__18, Press the Finish button to create the configurable service. 
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_19. 


_20. 


Retum to the Integration Toolkit. 
Select the Filter NET compute node in the DotNet message flow. 
In the Properties pane select the Basic tab. 


Change the Assembly name to SampleintegrationProject.dll, 
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__23. Select the Advanced tab. 


__24. Enter SampleDotNetConfigService as the AppDomain name. 
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__25. Select the Modify .NET compute node. 
__26, In the Properties pane select the Basic tab. 


__27. Change the Assembly name to SamplentegrationProject.all. 





Grave 
a 
"| a 
lcawasresme "(jie (M4 
fame — 
fas 

Ss 








oben oxin| TF Dera =as 





‘NETCompute Node Properties Meaty 


oat 





__28. Select the Advanced tab. 


__29. Enter SampleDotNetContigService as the AppDomain name. 
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__30. Select the Create NET compute node. 
__31. In the Properties pane select the Basic tab. 


__32, Change the Assembly name to SampleintegrationProject.all. 

















__33. Select the Advanced tab. 
__34. Enter SampleDotNetConfigService as the AppDomain name. 
faoon oa] Sa Sopa ==8 





ede ropertes- Create 


cman 




















38. RP corene updated message flow (Ctrl: 
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5.5 Deploy and execute the message flow 

1. Inthe project navigator expand DotNetApplication>BARs. 
2, — Select the DotNet.bar broker archive. 

3. Press the right mouse button. 


and Save Broker Archive from the menu. 









selva 
bene, 
lac 











Press the OK button to dismiss the warning dialog. 





© Overide configurable properties. =a) 











(Gy) _Vouzre about to override the configurable properties in the broker archive. This, 
option can be changed in the Prepare tab in the Broker Archive editor using the 
Override configurable property values option. 


Would you like to continue? 


[Do not show this warning again. 


Ce 
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__6. Select the DotNet.bar broker archive. 
__7. Press the right mouse button. 


__8. Select Deploy from the menu, 





PT 


EE patna 
Ether 

| eon 

mitteryrtow 


1 ace 








ae 








Ee eta 
oo st 





Select the default integration server. 


_10. Press the Finish button to start the deploy operation. 








Deploy 


Select integration server to deploy selected resources. 








“4 By Integration Nodes 
4 IBONODE 























Fini 





h Cancel 
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__11. Confirm that the deployment was successful. 












[EL Problems B= Outline 





i Properties 





Details 
> i [DotNet.ber] has been deployed to integration serves default on integration node IEONODE 


__12. In the project navigator expand the Flow Tests folder. 


__13. Double-click the DotNetApplication_LoyaltyProgram.mbtest test client file. 


Applicotion Development Hew. 
= cotnetaniicaton 

0-9 Fews 

a8 i “ : 

ab bas 


AT ma Livy References 
mh cometubrary 
eG ears 





The input data is shown below. 
<LoyaltyProgram 

/uww .example.org/applicant" 
ww. example.org/store"> 
ails> 
First Name>Ben</applicant :FirstName> 
LastName>Thompson</applicant :LastName> 
HouseNo>1</applicant :HouseNo> 
reet>Happiness Avenue</appl 







<applicant :Ay 
<applicant 
<applic. 
<applica 
<appl 












Street> 











<applicant : Town>Grumpyville</applicant :Town> 
</applicant :ApplicantDetails' 
<store:StoreDetal 

<store:Storel0>001</store eID> 








</store tails> 
</Loyalt yProgram> 
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14. Select the Configuration tab. 


__15, In the Deployment location section press the Change button. 





‘Canguration 


yt ett oe it dora 











2 ee ei || 











Pas eI 
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__16, Select the default integration server. 


__17. Press the Finish button. 











Specify deployment details > 
Titeseayer clk is aly enn f& 





Deployment location: 


2 ee aa ‘New Local Integration Node 
Connect to Remote Integration Node... 























Trece and debug 
Step atthe beginning ofthe flow during debugging 
Always use the same deployment location fer every tes run 








® ro | 






































Tab 5 - Using .NET in IBM Integration Bus Page 193 


IBM Software 


_18. Select the Events tab. 
__19. Press the Send Message button, 





























a f=) 
fo 
20. After the test has completed select the MQ Queue Monitor “DOTNET.OUT” item and review 
the result. 
co 
so et et + ers 
Tl ietSnor eee 
Peer =a 
(Zien ct cnt = 
ohio ene ORI 
Srconevome mere ree 
Eceneerotrmomer eset 
dhol 








_21. Close the test client. 


Stemmons 
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The test results will not be saved. 


__22. Press the No button. 


@ Save Resource ooo EX) 


@ ‘DotNetApplication _LoyaltyProgram’ has been modified. Save changes? 











The other path through the message flow will be tested next. 











__23. Double-click the DotNetApplication_SaleEnvelope.mbtest test client file in the Flow Tests 
folder. 


‘Application Development. New. 


DotNietApplication 
2 Flows 





2 Library References 
A DotetLibrary 
Gl ears 

Independent Resources 
1S Testclentarries 





5 
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24. The input data is shown below. 


<SaleEnvelope> 
<Headar> 
<SaleLiatCount>1</SaieListCount> 
</Header> 
<SaleList> 
‘<iInitial>R</Initial> 
init ial>Ac/Initial> 
<Surnama>Braithwaite</Surnams> 
<Codia>00</Cade> 
<Code>01</Code> 
<Cada>02</Code> 
<Descript ion>Twister</Descri 
<Categary>Games</Category> 
<Price>00.30</Price> 
<Quant ity>01</Quant 
</tten> 











‘<Cade>02</Code> 





<Coda>01</Code> 
<Descript ion>The Times Newspaper</Deacripticn> 
<category>Books and Mediac/Category> 








<Price>00.20</Price> 
‘Quant ityS01</Quantity> 
</ttem> 


<Balance>00.50</Balance> 
<Currency>Sterling</Currency> 
</invoice> 
<Initial>T</Initial> 
<initial>de/Initial> 
‘<Surnama>Dunnwin</Surname> 
<Coda>da</Cade> 
‘<Code>05</Code> 
<Code>D1</Code> 
scription>The Origin of Spacies</Dsscription> 
<Categary>Books and Nedia</Category> 
<Price>22.34¢/Price> 
Quant ityo02</Quantéty> 
</tten> 





<Cada>06</Code> 
<Code>07</Code> 
<Cada>01</Code> 
scription>Microscope</Description> 
<Categary>Miscellaneous</Category> 
<Price>36.20¢/Price> 
Quant itys01</Quantéty> 
</tten> 
<Balance>@1.84</Balance> 
<Currency>Buros</Currency> 
</invaice> 
</SaleList> 
<Trailer> 
Comp let ionTime>12.00.00</CompletionTime> 
</trailer> 
</SateEnvelope> 
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__25. Select the Configuration tab. 


__26. In the Deployment location section press the Change button. 





Configuration 





oy atin 
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__27. Select the default execution group. 


28. Press the Finish button. 


Cantoomeoee 


Specily deployment details 











This server instance is currently running. 





Deployment location: 


ee 
© rece oe ae 
‘Bas 























Trece and debug 
Step atthe beginning ofthe flow during debugging 
Always use the same deployment location fer every tes run 








® ro | 
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__29. Select the Events tab. 
__30. Press the Send Message button. 








+ ed prin 
San = Dace ogetin 
Er leo emt Digan Dalian a 




















3 
ies] 
ed 
__31. After the test has completed select the MQ Queue Monitor “DOTNET.OUT” item and review 
the result. 





vents 
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32. Close the test client. 


(Blcpanemcnmn siemceeT ST 


The test results will not be saved. 





33. Press the No button. 


(Qsoctanee ee 


e ‘DotNetApplication SaleEnvelope' has been motified, Save changes? 


ee | rr |r 














Page 200 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


IBM Software 


5.6 Cleanup 
1, Inthe Integration Nodes pane expand the IB9NODE entry. 
2, — Select the default integration server. 


3. Press the right mouse button. 


4. Select Delete All Flows and Resources from the menu. 






«4: Bg Integration N 
4 i IBONODE 
& Config 

> Wg, default 





__5. Press the OK button to acknowledge the warning and start the deletion. 








© Confirm Deletion on x 








e ‘Are you sure you wish to delete ll flows and resources ? 


The default integration server should now be empty. 














«4: ig Integration Nodes 
4 & IBONODE 
(& Configurable Services 


deta 


This is the end of Lab 5. 
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Lab 6 Working with mobile applications 


6.1 Overview 


IBM Integration Bus Version 9.0 contains four patterns that facilitate integration with mobile 
applications, through the Worklight product suite. This lab also makes use of the global caching 
function in Integration Bus, which has been activated in the VMWare image. The four patterns are: 


* Service, management 


The service management pattern integrates a mobile application written for the Worklight platform 
with a service running in IBM Integration Bus. You can use the pattern to make an Integration Bus 
service available through REST APIs invoked by mobile applications running on all types of 
devices. 


* Resource handler 


This pattern provides services to mobile applications that use the Worklight APIs. The services 
are exposed to mobile applications as Worklight adapter procedures that are invoked from 
JavaScript in the application. 


The pattern is customized by implementing handlers for each of these procedures as sub flows in 


IBM Integration Bus. The pattern provides security policy enforcement and global caching. The 
pattern uses REST calls passing data in a JSON format to the generated message flows. 


‘+ Microsoft .Net request and response 
This pattern integrates a mobile application written for the Worklight platform with Microsoft NET 


applications. This pattern makes a Microsoft .NET class available through REST APIs invoked by 
mobile applications running on all types of devices 


+ Worklight Integration from MQ 


The Worklight push notification from WebSphere MQ pattern sends notifications to Worklight 
mobile applications using WebSphere MQ. 
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6.2 Microsoft .NET request/response mobile pattern 
Return to the Integration Toolkit. 


Select File>Switch Workspace->Other. 








rdt_Navigate Search Project Run Window Help 


























ew MeSieNY Pe Five ero 
a 4 
ae Quick Starts 
Close all ic ‘Stan ding your applications 
BD Seat by creating an applicat) 
letcentii 
uM Sat by creating en integuat 
— Aninegn see em 
poet 
‘mh Seat by creating alibeany 
Cnet Denn Te : 
Ale aipren 
hes oe BF searefrom WSDL and/or xs 
>| aT Ute cea ns 
a Sees “ina youtee 
— Chaderphmaey eisai 
chance 
1B Bpon. Aste) 





‘Bi Taske) Hl Deplayment Lag) 
i een a | ae 
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__3. _ Enter C:\student\mobile\workspace as the Workspace (or use the Browse button). 


__4. Press the OK button to continue. 








= 
Select a workspace 


WebSphere Message Broker Toolkit - Message Broker stores your projects in a folder called a workspace. 
Choose a workspace folderto use for this session, 








Workspace: 








(CLEA the dea sida naka gail 
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__5. Inthe Integration Toolkit, select the Patterns Explorer. 
6. If necessary, expand the Mobile->Worklight categories. 


__7. Select the Microsoft .Net request/response pattern. 








Application Integration 
> Gil File Processing, 

> Gl Healthcare 

> Gl Message-based Integration 
> cll Microsoft.NET Integration 





> Service Enablement 
> Gt Service Virtualization 
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Take some time to read about the pattern. 


8. _ Press the Create New Instance button. 






















1 View Pattem Specification 
Venter bout the selected patente cick he Crte Ne stance bun rch ts a using pate ae 





Worklight to Microsoft .NET: request-response pattern 


Use the Worklight: Micrasoft .NET request-response patter to Integrate a mobile application written forthe 
Worklight platform with Microsoft .NET applications running in WebSphere Message Broker. You can use the 
pattem to make a Microsoft .NET class available through REST APIs invoked by mobile applications running on 

all types of device. 








Mobile Applications 
(VavaSerpuHTMLICSS) 


0 = 


WebSphere Mestage Broker 











__8. _ Set the Pattern instance name to MobileMedicalRecords. 


10. Click OK. 





© New Patter instance 





| 


Create New Instance wo 


‘The instance name uniquely identifies the patter instance project thats created whenthe pattern instenceis LIL 
saved or generated. The name ideally reflects the business and integration functions thatthe pattern suoports, 





Pattern instence name: 
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__11, Expand the Worklight section, 


12. 


Remove the selection from the Enable audit check box. Audit is not configured on the image 


and this will result in a null pointer run time exception if it is selected. 





% Configure Pattern Parameters 
rose values for pater parameter, Cle" Generate” buon ar cick here tagenrte patter instance 


}@ Configure the NET ssemby thatthe sevice, 
Poem Proetes 


i | al [> 





RE oe : 
te qo 
cuaa ; 


W Wire NET amen 
1 Service infomation 

> teasing 
 frorfanding 
Vom | 


__13. Collapse the Worklight section. 


__14, Expand the Microsoft NET assembly section. 


__15, Press the Configure button. 


Fer Premera 


Woktoht 


crac NEF accy 


‘aging 





"p Configure Pattern Paramotors 





0 comguese ME anarey at nese. 








ey ESS Eee 
+ Wenkight a + Werke ; 
| ancl 
Sait = eee 
1» Sevicebnformtion a 
+ Looging Ci) eal 
(re = 
— a 
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__16. Press the Select button. 





Configure Microsoft NET service 


isan 
Reni epson ieiaeia SWE 








Assenbly filename Retesh 





‘Assembly Information 





(aes name: 





Methars on the class thatthe series will invoke 


ethos Name Abdroct Static Public —~Prvte=— Return Type Nullble Web Method 


__17. Navigate to the C:\student\mobile\assembly folder. 
__18, Select the EMR.dll assembly. 
__19. Press the Open button. 


Select NET ase) ee 


ro a SOT NG a 


SS 











“oe Favontes Name Datemodifes Type 


Application 


Hi dsktop 18] Barkingtpptcation al 
1 Downloads Qe 
Recent Pacer 








Source, aK 





Vial C= Project 3K8 
OAD/22558PM_Applicabon eters. 51a) 


‘Dy Libres E 10/1V9012558M PDB Fie 14K3 


2 Documents 
ab Muse 
Ficus 


Bi viceos 





10/13/902653 PM Compresced spp 2548 


Computer 
i, Loca Dsk (C) 
(Shares Folsers( 


Filename: EMR. 
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Notice that six methods have been extracted from the .NET assembly file. All the extracted methods 
have been selected. 


_20. Accept the default selections. 


_21. Press the OK button. 





‘configure Microsoft NET service 
Configure your NET assembly that the sernce invokes 








Koucam \tudetnobieaseh Ma || 
Des boron 
Geter (ae = 





Matheds onthe class tha the sevice wil ike: 











Matos Name Absvact State Pubic mate Return Type Nulsble Wied Methed a 
i Geatenttistery No Yee ve No System Sting No Ne 
I, FindPaten MAN No Ye Ye No Stem Sting No No 
I, Getvtlsigne No Ye ve No system Void No Ne 
|W, Gettdesiestons No Ye Ves No Siptem Sting No No 
F GetLabResus No Ye Ye No System Sing No Ne / 
I RequestTet No Yes Ye No ‘System oid No Ne 
N No Vs Sytem Sin No : 
No No fe No sytem Boo No 0 4 
Code ‘ Ye he f } 
Sele A [chee Ail 
Potente 
Poremeter Name Type Inout Output——Aference Optional alte 
Man Systerstrng ves No No No No 
ssdited SjtemBoole No Yes Ne No Ne 
leetAdmiDate Sytersting No Ye No No No 
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The selection should now be shown in the Microsoft .NET assembly configuration. 





% Configure Paltern Paramoters 
Pee espn peers lth ‘Gene’ tena ta ene tanita, 


1 Paton pumas nacy Cee "Goet’ batonte genie petite. 














imran er 3 
5 Wes wena 
= Wc Fey = Oo lice 
ewe a =o 
1 Serucetformation e — 
iis . ee 
rv Ranting a imu 
Tema = 
__22. Collapse the Microsoft .NET assembly section 
__23. Expand the Logging section. 
__24. Select the Logging required check box. 
% Configure Pattorn Paramstors 
1 Pen porn we mylene tne et penn 
ee FEW perenne 
+ Wark Cir iid 


a ancy Ol) i) 
Seve itmntn = —— 
@ 
a] | 9 
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__25. Collapse the Logging section. 
__26. Expand the General section. 
__27. Enter MOBILE. as the Queue prefix. Please do not forget the period at the end of the prefix. 


__28. Press the Generate button. 





Ye Contigure Pattorn Pararnoters 








iS | een oat Date 











veep ficial} 











The pattem will take a couple of minutes to generate, after which the following projects will have been 
created in the toolkit navigator. 


+ Application: MobileMedicalRecords_DotNetServiceApplicationFlows — the main flow. 


+ Library: MobileMedicalRecords_DotNetServiceLibraryFlows — where you put your own flows — 
will not be overwritten if the pattern is regenerated. 


+ Independent Resource: MobileMedicalRecords_TestApplication — Worklight Adapters. 


__29. Close the Pattern Configuration editor. 


88 MobileMedicalRecords - Pattern Configuration [3] 


__30. Close the Pattern Specification window. 
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__31. Expand the generated projects. Observe the message flows that were generated. 


‘A Worklight adapter project (MobileMedicalRecords_TestApplication) has been generated under 
Independent Resources. 


Application Development New. 


o (Bil baerninstances] 
a Fil NobileMedicalfccords DotNetSericeAppliation Flows 
el 
2 £2 Flows 


a en eal 





» 1% MobileMedicalRecords DotNetServiceApplicationFlows 
4 (By References 
A MobileMedicalRecords_DotNetServicelibraryFlows 
14. BA MobileMedicalRecords DotNetSericeLibraryflows 
GS Schema Definitions 
> @ WSDL Definitions 
« & Flows 
28% masi 
DotNetServiceCustomafter.msgflow 
5 DotNletServiceCustomBefore.megfiaw 
4 Bi Independent Resources 


» BE MobileMedicaRecods TestAplcation qq 





The message flows use MQ queues. The queues will be created next. 


__32, Either return to or start MQ Explorer. 
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_33. Expand Queue Managers-IB9QMGR. 
__34, Select the Queues folder. 


__35. Press the right mouse button. 


36. Select New->Local Queue from the menu, 












File 





Edit, Window Help 





= Bi) Gi MQ Explorer - Content | F IBINODE Administration Lo 


Message Source Timestamp 





TBM WebSphere MQ 
9 Bi Gucue Manages: 












z Model Queue. 





‘Object Authorties 1» |___ Remote Queue Definition. 
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__37. Enter MOBILE.LOG as the Name of the queue. 


__38, Press the Finish button to create the queue. 





Create a Local Queue 


Enter the details ofthe object you wish to create 


Name: 





Select an existing cbject from which te copy the ettibutes for the new object, 


SYSTEM DEFAULT.LOCAL QUEUE 





\When this wizard completes, another wiard can be started automatically to create a matching object 
[Tstart wizard create 2 matching JMS Queue 






































| 
| 
Wm 
|| @ Bsc 
_39. Press the OK button to dismiss the dialog box. 
"“@ IBM Websphere MO (cml 
The object was created successfully, (AMQH48) 

[bo not show success messages in future 

(To re-enable, go to the MQ Explore: preferences) 
| 
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_40. Select the Queues folder. 


__41. Press the right mouse button. 


_42. Select New>Local Queue from the menu, 






= 6)’ @l MQ Explorer - Content  ¥ IBINODE Administration Lo 


Message Source Timestamp 








‘Alias Ques 
Tests » | Model Queue. 
Object Authorties >| Remote Queue Definition. 
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__43. Enter MOBILE.ERROR as the Name of the queue. 


__44. Press the Finish button to create the queue. 





Create a Local Queue 


Ente: the details of the object you wish to create 





‘Select an existing object from which to copy the attributes for the new object. 


SYSTEM. DEFAULT.LOCAL QUEUE Select. 


When this wizard completes, another wizard can be started automatically to crestea matching object. 
ElSiai weaid is Gestea maithing IVS Queue 


® Back 























a aaaaaaaeezedn 


__45. Press the OK button to dismiss the dialog box. 


"@ eM Websphere MO ren x 





i) The object was created successfully. (AMQU148) 


(7]Do not show success messages in future 
(To re-enable, go to the MQ Explore: preferences) 
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__48. Close the MQ Explorer. 


 seiieasonteg) 





2 Oasn espe 2 








Il “Se cota Gece 

|)“ « srsmance i nm = 
vero I ie 
Pa — Gene Opwinp ct Operant Conat yh PE 


__47. Select the MobileMedicalRecords_DotNetServiceApplicationFlows application. 
__48. Press the right mouse button. 


__49. Select Deploy from the menu, 








‘Application Development Ng Convertto Library 
Export XSDs from Application 
Migrate 


MobileMedicalRecords_TestApplication (peuse, 


Import... 
Export. 


BE 


Refresh 


Build for masipackagebar 
© Test 





BA ntegra 2 \_SE Outline] Data So] AI Tasts] | 
Team » 
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__0. Select the default integration server. 


__51. Press the Finish button to initiate the deployment. 








@ Depoy 


Deploy 





Select integration server to deploy selected resources. 








“4: Integration Nodes 
4 &i TBONODE 

















® 


52. Press the Yes button to dismiss the warning dialog box. 


Ce) 


The selected flows can not be added to the BAR fle without compilation, Do you 
‘want to add the flows to the BAR file ¢s CMF? To avoid this disleg you can deselect @ 
‘workspace preference ‘Deploy flow resources without comoiling for automaticaly 
generated BAR files’ Set the preference using 'Window-> Preferences-> Broker 
Development-> Build Broker Archive! panel. 











Cae 
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The deployed application should be visible in the Integration Nodes view. 








BB Date Source Esplorer] 3 Tass] 





«4 ig Integration Nodes 
2 BSNODE 
4 & default 
“4 &Hl MobileMedicalRecords DotNetServiceApalicationFlows 
Gl masiDotNetSenice 
4 BA MobileMedicalRecords_DotNetServiceLibraryFlows: 
BEM 
EMR 
[2 EMRSenice 
IBMdefined\org\w3\wnw\xml\_1998\namespace\xm! 
IBMdefined| org\xmlsozp\schemnas\soap\envelope\soapenvil 
IBMdefined|\soap 





__53. Close the Integration toolkit. 











o- © erOra- oa aaa) 
[EAypcon Deiogrert £7 SL Pots Epos] Js 
Alton Deore ‘Guiek Stans 

Dies Suman epleion th ne thefts 

[E MovmetenbeeesDmiarcypeont oor 

mn 





Dario  fiemscaegsnsrten 
[E Ineacettenaces, ae 


__54. Press the OK button to confirm the exit. 
pesener i ea 


e Exit IBMIntegration Toolkit? 





lAlwaye ext without prompt 


| See | 
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6.3 Deploy the Worklight adapters and test the application 


__1. Open the IBM Worklight Studio, using the icon on the main window. 





_2. Select the C:\student\Worklight\workspace directory. 
__3. Press the OK button to open the workbench. 
‘Workspace bet 


Select a workspace 





IBMG Worklight Studio stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session, 


Workspace: C:\student\Worklight\workspac= 





VWs vices the cetanlem cian notack sea | 
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__4. Inthe Project Explorer, point to a blank area 
__5. Press the right mouse button. 


_6. Select Import->Import... from the menu. 


ERG 





(i Project Explorer 23 














AlltShift+W > 






opy Ctrl 





Copy Qualified Name 
(B Paste trey 
% Delete Delete 








‘App Client JAR file 
EARfle 

& EIBIAR ile 

BA Java EE Utility ar 
@ RaRfile 
 warfile 


1A Sport. 
©) Refresh 





by [impor 
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Expand the General folder. 





__8. Select Existing Projects into Workspace. 


__9. Press the Next button. 








Create new projects from an archivefile or directory. E4y j 





Select an import source: 
typefiltertet 











4 General 





©) Preferences 
> @ Android 
> & Os 
> & EB 
> & Git 
> & Install 
> @ lavake 
> @ Plug-in Development 
> @& Remote Systems 
> @ Run/Debug 
Ga Tacke is 























® Bue 
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10. Press the Browse button next to the Select root directory text box. 





|| Import Projects 


Selecta directory to search for existing Eclipse projects. 


Sz 





@ Select root directory: | 








OSekctarchiveric | 


Browse. 





Projects: 








Select All 
Deselect All 











‘Copy projects into workspace 
Working sets 





dd project to working sets 


Working sets | 


=| see 
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__11, Navigate to the C:\student\mobile\workspace\MobileMedicalRecords_TestApplication 
project. 


12. Press the OK button. 


[i ] 


Selectroot drectory ofthe projects to import 


a baa a 


> resources 
4 Mfeorispace] i| 
> S umetadata || 
“L, GeneratedBarfilez 
> fl MobiteMedicalRecords 
» | MobileMedicelRecords_DotNetServiceApplicationFlows 
Ap 


r braryFlove 


Folder, NobieMedicaRezords_Testapplcation 


ran am] 
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__13. Select the Copy projects into workspace check box. 
__14. Press the Finish button to start the import. 


Import 


| Import Projects 


| 


























@ Select root directory: Ci\student! mabile\workspace\ MobileMedicalRecords_TestApplication ees 
ne 
| 
aa 
Ce) 
‘Working sets 
Watking seb [ |= 








@ ere 
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__15. Expand MobileMedicalRecords_TestApplication->adapters->MobileMedicalRecords. 
__16. Select the MobileMedicalRecords.xm! file. 
__17. Press the right mouse button. 


__18, Select Open With Adapter Editor from the menu, 











TS Proce plore | >| al = 5 || Fon 
BS\e 
4 8) MobieteicaRecor, Tesippss cance |) Bread Common XM Eakor 
RE Stem bry] eee 
ne cutey_| i XM Etior 
1 Been Delete |} Sytemeseo 
1 © enact | = tana Cote ChianeSiteDown |) ie Plc or 
Mea 
J. 15) MobileMedicalRecords-i J] Mare as Lancimark Chi AiteShitt+Up Defoult Editor 
ops Build ath a 
oi appr bedap ee 
baja Rename R 
Sen es Ip. 





__19. Examine the contents of the adapter XML file. 


__20. When finished close the editor. 











Adapter Editor 


Overview (imc (deta 
ype fitertest ~ Lead Constraints 








1 ap "MohiebdicalReconde™ 
> [IB Conneetiey] 

‘@ Froceure"FindPatentMRN 
@ Procesure“Geasterts” 
Procedure "GeMecatone’ 
© Proceduie “GePaientitay” 
@ Procecure"Geitasign” 
4 Procedure RequestTest” 


Mavconcunent connections pernede': 


‘The maximum numer ef concurrent request that can be performed en 
the back-ene agpietion 
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__21. Double-click the MobileMedicalRecords-impl.js java script file. 


{[&S Project Explorer 52 \ 6S7 =o) 
2) MobileMedicalRecords TestApplication 
BA JRE System Library [<7] 
@ serverfjava 
BA JavaScript Resources 
& adopters 
& MobieMedicalRecords 


MobileMedicelRecords-impl 





@ apps-backup 
& bin 

& components 
& server 
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__22. Scroll down so that some of the individual methods are visible. 


__23. After examining the Java script file close the editor pane. 








© function GetPatientHistory (MEN) { 
var parameters - new Object ()7 


parameters ['MRN'] = MRN? 
var input = PrepareWebService(‘cecPatient#iscory’, peramevers, targevPach) ; 
WL.Togger.debug('SOAP request: ' + input.body.content)? 


return senckequest (*GetPatientiiscorysespons 





+ ampat)? 


© sanction FindPatientifN(name) ( 
var parameters = new Object |)? 
parameters['nem='] ~ name, 
var input = PrepareWlebService('FindFatientWRN', paraneters, targetPeth); 
WL.Logger.debug('SOAP request: ' + input-body.coateat); 
vetnrn sendRequest ("FindPatientMRWRespense', input)? 











function Gecvitalsigne (HRN) ¢ 
var parameters = new Object |): 
parameters ['MEN'] = MRN; 
var input = PrepareNebService(!GetVitalSigns', parameters, targetPath): 
WL.Logger.debug('SOAP request: ' + input.body.content); 
wotura sendRequeet (1 GerVstalSigneRespanss!, input)? 


2 


© function GetMedications (MBN) { 
var parameters ~ new Object |) 
parameters ['MRN'] = MRN? 
var input = PreparewebService('cetMedicaticns', paranevers, vargevPath)? 
WL Logger debug('SOAP request: ' + input.hody.content)? 
return senoRequest ("GectHeaicaticnsxesponse", impat); 
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The TestApplication application was created with an earlier version of Worklight. There have been 
subsequent changes in Worklight that must now be corrected so that the application can be used with a 
recent Worklight studio. 


__24, Expand MobileMedicalRecords_TestApplication->apps->TestApplication->Common->js. 


__25. Select the js folder. 


__26. Press the right mouse button. 


__27. Select Import from the menu. 


[S Project Explorer 5% 





4 BB MobileMecical 
BA JRE System 
(& server/java 

> BA JavaScript Re 
4 © adapters 
4 & Mobilet 
(ici Mobi 
> [ Mobil 
4 apps 
4 © TestAppl 
4 com 
>@e 
> Bit 
4 js 











xf 





Show In 


Open 
Open With 


Copy 
Copy Quaed Name 
Paste 

Delete 

Remove from Context 
Marks Landmark 
Build Path 

Move.. 


Rename. 


‘Show in Remote Systems view 


Run As 


Alte Shifts W > 
B 


Cirle 
Ctriey 
Delete 


Ctrl Alte Shift: Down 
Ctrl+ Alte Shift Up 


rR 


5 
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28. Expand the General folder. 
29. Select File System. 


30. Press the Next button. 








r 
Import resources from the local filesystem into an existing project. Ea 





etonenaecees 
‘ypefitertet 
26 
EE Acive Fle 
1S Baisting Projects into Workspace 
q 
Ey Preferences 
> @ Android .| 
> eas 
> SEB 
> & Git 
> Insta 
> @ Java EE 
> tae tanec 
> @& Remote ystems 
> @& Run/Debug, 
ues 











» 


























Finish Cancel 
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__31. Press the Browse button to the right of From directory. 








| File system 


Fromdirectory: 





























[[Fiertypes. | [_seectar_] [ Deseectan_] 


Into folder: MobileMedicalRecorés TestApplication/edapters/MobileMedicalRecords Browse.. 


Options 





Overwrite existing resources without warning 
Create top-level folder 








Advanced >> 








® rr Te | 
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__32. Navigate to the C:\student\mobile\resources directory. 
__33. Select the fixes directory. 


__34. Press the OK button. 





Import from directory Lets 


4 





Selecta directory to import from. 





4D mobile * 
B assembly 

BD ate 

| 9B ict G 


| Lema 


| a lk : 
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__35. Select the initOptions.js check box. 


36, 


Press the Finish button to perform the import. 








File system 


Fromdirectory: C:\student\mobile\resources\fines 











WG fas 





Tel Testapphcation.html 














(esa 


Into folder MobileMedicalRecords_TestApplication/adapters/MobileMedicalRecords 

















= 
® <Back |New Cancel 
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The TestApplication.him file must also be fixed. A complete replacement file is available in the 
C:\student\mobile\resources\fixes directory. 


__37. Inthe Project Explorer double-click the TestApplication. htm! file. 


BPrjectoporr ss Sle - | 
> B) MobiiertedicatRecor 
4S ap 
“4 i Testappliation 
2 § common 
> as 
bk iraage 
PEs) 
> controllers 
> & doo 
» & dojox 
> B auths 
» BD intOptionsje 
> BB messagesjs 
[B restConti 











{application descriptarsen! 


__38. Scroll down so the Body element is visible. 


__39. Delete the highlighted text (onload="WL.Client.init({})"). 





[8 TestApplication.ttml 2 
q 2a 











Skin: comme 





(2) oo) (Bla | & | LB bWce sendand 














=" visibility:hiddens"> 
2.ScraLlaalevien” id="nainvienuVien” selectede"true"> 
‘dojox.mobiLe.neading”>Test application! </hi> 

sh2 data-dojo-type="dojox.nob tLe. edgeTotdgeCategory"»Operations</h2> 

la cul data-dejo-type="dojox.mobile.EdgeToFdgeList” transition="zo0nEn"> 

a = <li data-dojo-typo~"dojox.nobile. ListTton" label~"GetPatientHistery” 

la 

rs 














noveTo="GetPatienthistoryRequest” urlTarget="neinContcinen"></1is 
a <li data-daja-typs-"dajow. mobil. 












jo noveTo="FindPatientRuequest” urlTarget 

a= <li date-dojo-type="dojox.nobtle, ListIten” lebel="Getvitalstgns” 
ja noveTo="GetVitulSignstequest” urlTarget="mainContainer"7</1i> 
ja <li date-dojo-type-"dojox.nobile, ListTeen” label-"Cetiledications” 
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__40. The result should look like the following. 


afmcaseges Ja" ¥e/acrape 


‘js/auth. js"r</script> 





<script sre 
kscript src= 
</head> 
= <body ic-"content” style-"visibilityshiddens*> 
idiv data-dojo-type="dojox.mobile. ScroLlabLeView" id-"naintienuView" selected: 
4h data-doje-type~"dojox.nobi Le-Heading"sTest Application! </h1> 
2h2 data-dojo-type="dojox. mobi Le. Edge ToEdgsCategery">Operations </h2> 
e aul data-dojo-type="dojex.mobi Le. FdgeToEdgeList” transition="zoomIn"> 


@ 213 data-dein-tunes"divinw.mbile JictTten" Iahelo"GetPatientiitctare” 








"true" 














__41. Scroll down to the end of the body. 





</div> 
= <div class="nblsinplepiaLogrext”>test: 
<input data-dojo-type-"dajox.mobile. TextBox" id~ 
</div> 
</div> 
2 <div id 








equestTest_test"/> 





equestTestResults” data-dojo-type="dojox.mobile. Scrat LableVien"> 

le <hL cata-cojo-type="dojox.mobile.Heading” back="Paraneters” novelo="KequestTestkequ 
cha data-dojo-type~"dejox. mobile. EdgeToFdgeCategory">Results</h2> 

<div ide"fequestTestResultsList” data-dojo-type="dojox. mobile. EdgeToEdgeList"></div 

















<h2 data-cojo-type="dojox.mobiLe. Edge ToEdgeCategory">General</h2> 
<div ide"RequestTestGeneralResultsList” data-dojo-type="dojox.mobile. EdgeTobdgelist 
</div> 
</B> 
</html> 


__42. Insert the following statements before the </body> statement. 
<script sre="js/initOptions js"></script> 
‘is/TestApplication,js"> 





“js/messages js"></script> 





"RequestTestResult: dojox.mobile.ScroLlableView"> 
<hl date-dojo-type="dojox.mobile-Heading” back="Paraneters” noveTo="RequestTestReq. 
<h2 date-dojo-type: EdgeToEdgeCategory"»Results</h2> 
<div ide"RequestTestResultslist” data-dojo-type="dojox.mobile. EdgeToEdgelist”></dix 
<h2 date-dojo-type="dojox.mabile. EdgeToFdgeCategory"General</h2> 
<div ide"RequestTestGeneralResultsList” data-dojo-type="dojox.mobile. EdgeToFdgeList 


























> 





</html> 
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_43, RAPE cave tne modified hin fle (Ctriss). 


__44, Close the editor. 


jon.html 





TestApy 





__45. Select the MobileMedicalRecords adapter. 
__46. Press the right mouse button. 


__47. Select Run As->Deploy Worklight Adapter from the menu. 





















‘TS Project Explorer &! = FE Outlir 
af = | 
4 2D MobileMedicaiRecorde Testip, bison ‘An outliny 
b a IRE System Libray 8] | Showin AteSnitou > 
B seven 
+ ah Ing Resouces co cee 
15 sae ory ste Name 
STR rae cum 
1b  MotileMedcalReco Ddete 
van cs A sntDown 
1S septate sutsPan , 
on a 
Sees os a 
Be WonighDondpmen Scvel 
Beer 
2) Refresh 5 
Vote 
Shon eto ion 
at) 
Emer » |i. waters Baad Senice 
Prfless » | awoke Werinke Pecedre 
ne | Recor 





__48, Use the console icon to select the Worklight Console (if necessary). 


a 7 


ployltg atptrs to iaredeataocere sino 
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The results of the deployment should be visible in the console. 


49. Confirm that the adapter deployment was successful. 


Spa 


TB Markers | Ei Properties | 4 Servers |Wfj Data Source Explorer 
|Worklight Console 














[2013-27-17 23:38:07] Starting adapter deployment on Worklight Server 
[2013-97-17 23:38:08] Deploying adapter: MobiletedicalRecords 
[2013-27-17 23:38:03] Server host: locelhost 

[2013-27-17 23:38:08] Server port: 808@ 





[2013-07-17 
[2013-27-17 


38:12] FWLSEO0S4I 
3:38:12] 


Records’ successfully. 





Adapter deployed successfully 


Start a Google Chrome browser session. 


__50. Double click the Chrome icon. 





__51. Navigate to http://localhost:8080/console. 


__52. Expand the Show details area. 





€ > ¢ (feces = 


IBM Worklight Console elev Cutt Lac Aaat 
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The procedures in the installed adapter should be visible. 


__53. Minimize the browser session. 


IBM Worklight Console ‘Welcome, Guest |Lagout |About 





odes xoes 
@ errata 
ee coms: tw ane 
Pr te 
pea loahot 





‘Seepnon cap 208 mer a ns 
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__54. Return to the Worklight studio 


__55. Select the MobileMedicalRecords adapter. 


__56. Press the right mouse button. 


__57. Select Run As>Invoke Worklight Procedure from the menu. 








Kt 





“95 MobileMesicaReconds Tesppicalion 


BL RE Spter iran 7 
B serine e% 
BA Ivecrp! Resource 

4G aliyies 


1 Mobieiteicaiecordy 
MobleMedhcfe 
1B MotieMeticete 
Som 
S epostackup 
>ebin 
& components 
» @ ene 





g 


nap 
i 


E Outline & 
[An outhne not avai 





# BE 
¢ 
a 


ees 


alcate 
Run A 

Debug As 

Profle Ae 

Teo 

Compare With 

Restore rom Local Hitor= 








Ale SritesW > 


cutee 


ciey 
Delete 





‘AR= Shi A 


>] a Run on saver 
>| @ 2 Deploy Wosktigh: Adapter 


| 3 nvoke Wrkight Back-end Service 
» |e [Elnvoke wortight Proce 

*) un Configurations 
_——————— 
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The Worklight test client should open. 
__58. Use the drop-down menu to select GetLabResults as the Procedure name. 


__59. Enter 12345 in the Parameters field. 


80. Press the Run Button. 











Name Invoke Procedure MobileMedicelRecords Test Application - MobileNedicelRecoids 




















vce recur its 
Proectrane _(MabieNedisliscons Totipesaion = 
Apter name: [MatieMedialRecorés =| 








Procedure name: 








signature: 
(GeeLabResults (MAN) 





Pararneters (comma-separated 

















® Cee | 
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The Worklight test client will invoke the MobileMedicalRecords Worklight adapter, which in turn will 
invoke the message flow (a service that encapsulates the .Net application) 


The Test Client will show the value that has been returned from the Integration Bus application when the 
GetLabResults procedure is invoked for patient 12345. In the example below, a result of TSH 2.460 
ulUVml for patient Salvadore Monella was returned. 


__61. After examining the results close the Invoke Procedure Result window. 








© tvekeProceae Rea] =a 
Invocation Result of procedure: 'GetLabResults' from the Worklight Server: 
; : 





NieSuccessful": tzue, 

"responseHieaders": { 
"Content-Length": "319", 
MContent-Type": "text \/sml;charset=utf_2", 
"Date": "Tha, 18 dul 2013 03:42:31 GMI", 
"Server": "Apache-Coyote\/1.1" 








he 
"responseTime" 
result": { 





738, 










stacuscode 
jstatusReason” 
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6.4 Test the adapter using the Android emulator 
1. Select the down arrowhead next to the Worklight logo on the toolbar. 


2. Select Worklight Environment fram the menu, 





File Edt Navigate Search Project Run Window Help 














eg a] 


= El +X © 1@ Workight Project 


epaatepera's: Worklight Adapter 


6 
TD Worktight Hybrid Application 
4.9 MobileMedicalf [J Worklight Inner Application 
BAIRESjstom 
a 


> GB server/java 


Worklight Shell Component 
Worklight Native API 





‘Worklight Application Skin 


Worklight JSONStore 
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name. 





Select the Android phones and tablets check box. 


Press the Finish button to create the environment. 


Worklight Environment 
Create application folders for new environments, 


J) emisanane [onieMescaecoras TestAppicobon 


















Application/Component] 


(Create folders for: 
Mobile 





TB BlackBery10 
Bl Windows Phone 75 
(5) By Windows Phones 
Desktop 
7] Bi Windows 8 desktop and tablets 
Bl Bi Adobe air 
5 © Windows 7 and vista (Deprecatec") 
5 Bi Mac 08 X Dashboard (Deprecatec") 
web 
Mobile web app 
7) Desktop Browser web poge 
 F Fecebook (Deprecated* - Use Ds 
7) BW icoogle (Deprecates* - Use Desktop Browzer instead) 





1op Browser instead) 





These environments will nt b 





upported in the next release of IBM Workligh 





® 











Use the drop-down menu to select TestApplication as the Application/Component. 


Use the drop-down menu to select MobileMedicalRecords TestApplication as the Project 
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‘An Android mobile application is generated. The application can require more time to load than the 
default time out values will permit. This will now be corrected 


7. Wait for the new project to be generated. 
8 Expand the MobileMedicalRecords_TestApplicationTestApplicationAndroid folder. 
9. Expand the sre->com.TestApplication folders. 


__10. Double-click the TestApplication.java application, 





[& Project Explorer 5 | is eel 
> 9 MobileMedicalRecords, TestApplication 
|| «15 MobiteMedicalRecords, TestApplicationTestApplicationAndroid 
4@ sc 
4 BB comTestApplication 


> B_GCMIntentSonicejave 
> festappticationjava 
8 gen (SESE 
> A Android 4.2.2 


__11, Insert the following statement as shown in the screen shot below: 


this. setIntegerProperty("loadUriTimeoutValue", 70000); 





LD] “TestApplicationjava 33 | 
package con. TestApplication; 





import android.os.Bundle; 
public class Testapplication extends WLDroidGap { 


= @override 
public void onCreate(Sundle savedInstanceState){ 





+ 


ey 
* onliLInitConpleted is called when the Worklight runtime framework initialization 
“f 

S  @verride 

“a public void onbiLInitCompleted(Bundle savedinstancestate){ 

‘super. loadUrl (getilebilainFilePath()); 

// Add custom Initialization code after this Line 
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_12, RAPE cove tne moditied java program (Ctrl+S) 


13. Close the java editor. 


[Bi tevtprnsonjooQE] 


In order to access the adapter from a virtual phone, the location of the test server must be specified. The 
IP address of the VMWare image must be used. The IP address will ely be different from what is 
shown in the screen captures in this document. 


Start a DOS command prompt. 
__14, Select the DOS command prompt icon 


__15. Press the right mouse button. 


_16. Select Command Prompt from the menu. 









Unpinthis program from taskbar 








Closewindow 
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ait 


_18. 
shown below.) 


Execute the ipconfig command. 


Take note of the address of the VMWare image. (N.B. The address may be different than is 





Sere 


Windows IP Configuration 


Ethernet adapter 


Connection-specific DNS Suffix 
Link-local IPu6 Addwece . 


IPu4 Address. 
Subnet Mask. 2 
Default Gateway 2 2 1 


Local Area Connection: 


localdonain 


192.168 .162.2 


Tunnel adapter isatap.localdomain: 


Press the right mouse button. 


a1 


[|| + & motitemedicattecoras_TestApplication 
BA IRESyter Library Gi 





In the Worklight Studio, select the MobileMedicalRecords.xml adapter specification file. 


Select Open With->Adapter Editor from the menu. 





B zener/java Ge Z 
Bh JaveScpt Resources a5 ar 

2 adaptes bes : 
4 MobileteicaRecorés 

MobileMedicaRecorisam Oren With OC) eens 
om see Bete 
 oppe-backup a) XML Editor 
ben Paste cy 
 compenents ® Ddee Deke |B System Ector 
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__22, Expand the Connectivity folder. 


ie IP address of the VMWare image, as ascertained 


__23, Select the Connection Policy tab. 

__24, Change the Domain address to match th 
above. 

_25, | Save the adapter specification. 

26. Close the adapter editor. 


ee ere | 
Adapter Editor 











GE Aig WabiaaaR eco? 
4) Conectvay 

1 Procedure FrnPatetaR 
1 Procedie "Gabe 

1 Procedne"GtMeteaton 
1 Procedine"GelPaintHetny 
1 Procedure Get tale 

1 ProcedieRequesTes 











_27. Close the DOS command prompt. 


Dela 
Domains [nearereoat0 
Pest 750 


Sets how the HTTP adapt hans cookies ating om he back-end appt 


Macredieats 0 








Themasmur numberof eves that the TTP adept shoud foo, The ual 
\henthe back-end apleston send iu rest aaest of tome er, seh at 








+\>ipconf ig 


Windows IP Configuration 


lEthernet adapter Local Area Connection: 





=) 
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__28, Select the MobileMedicalRecords adapter. 
__29. Press the right mouse button. 


__30. Select Run As>Deploy Worklight Adapter from the menu. 











Braqeatpom =| = =o] our 
New > 
a 
4 3D MobileMedicaiRecords TestAg, Somme |An outliry 
mnesmeniay ts | Sun teshatow > 
> GB senevava 
1 mh leer Reaunces, ay cutee 
2 adapter 


(Copy Qualified Nome 


> MobieNedcaReco| = 6” uy 


Ei MobileMedeaecs 
2 MobileMedicaReco 





Delete Delete 





eae Time tr Contes iis Alte ShiftrDown 
» & appsbackup ule Path > 
S bin Move. 
components 
(ene eneme.. R 
1G} Workight Development Serer| ve Import. 
1d Eipor 
2) Rettesn 5 
alate 








aba Ae 9 | 89 Dnwoke Werkight Backer Service 
Profle As » |e Invoke Werkight Procedure 
Team 





un Configurations 


__31. Use the console icon to select the Worklight Console (if necessary). 








leet co Deploying capers fa ateceatnccords 


The results of the deployment should be visible in the console. 


__32, Confirm that the adapter deployment was successful. 











{[EL Markers |i Properties #i Serves |i Data Source Explorer| [5 Snippes| EI Console | i 
‘Worklight Console 

[2013-07-17 23:38:07] Starting adapter deployment on liorklight Server 
[2013-07-17 23:38:08] Deploying adapter: Mobi letiedicalRecords 

[2013-07-17 23:38:08] Server host: localhost 

[2013-07-17 23:38:08] Server port: 808¢ 


[2013-27-17 23:38:12] FWLSEo0s4z. Records’ successfully. 
[2013-27-17 23:38:12] Adapter deployed successfully 
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__33. In the Worklight Studio, expand the apps folder. 


__34. Select the TestApplication mobile application. 


__35. Press the right mouse button. 


__36. Select Run As-Build All and Deploy from the menu. 










‘mi JRE System Library [jre6] 
> GB server/iava 


14-2 MotileMedicaiRecords_TestApplication 








> BA JavaSciipt Resourc 
4 & adapter 
4 @& MobileMedicalF 
[Gl MobiteMeai 
>) MobileMed 
4 apps 
(j> TestApplication 
i android 
> (common 
» Ej mobilewebs 
application 
> @& apps-backup 
> &bin 
& components 
> @& server 
> 39 MobileMeticalRecords 


Outline 23 


|An outline is not available, 






















xe Pw 





Show In Alte Shifts W > 


Copy Cirle 
Copy Quaified Name 

Paste ctrev 
Delete Delete 
Build Path > 
Move... 


Rename. Fo 
Import... 
Brport.. 
Refresh FS 


Validate 


hina 


Debug As 
Profile As 


Run Configurations... 





Wait for the TestApplication application to finish building, 








[EE artes) Propertes| il Servers Bl Dsta Source Explorer Snippets Console © 








ale e- 





ae Se ee re 
‘Application “TestAsplication’ with environsent ‘ancroid” build finished. 
‘Storting build process: application "TestApplication’, all enviroments 
Project. 'NobiletedicelAecords TestéoplicationTestéoplicationéndraid’ was inported. 








Application "Testapplication™ with atl environsents bulld fintshed 
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__37. Return to the Web Browser session. 
__38, Press the FS key to refresh the screen. 
__39. The TestApplication application should now be visible. 


__40. Click on the Preview as Common Resources hot spot. 











Testappcanon 
\ovgrte easen NET test ppeton 
Lestupataa st 20130620 0848 

@ > Ge Vetsion 10 @ Ake © secuyTest eu 
x @ Bren Version 10 Getsna Un, 











sorsopg00sst 





gtr apt 





Anew browser tab should open. The HTML version of the application should be visible. 


__41, Select the GetLabResults line. 








FACere [ Tettepaton= com» 








© 1D locanoscaa0/an 


GotPatientHistory 
FindPatientMRN 


Getvitalsigne 


GetMedications 
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__42. Enter 12345 in the MRN field. 


__43, Press the Invoke button. 





__44. Confirm that the results screen is displayed. 


Parameters GetLabResults 


Results. 
TSH 2.460 ulU/ml for patient Sal 
Monella 


idore| 





isSuccessful true 








statusCode 200 
statusReason OK 


The Android virtual device manager will be added to the toolbar. 
45. Return to the Worklight studio. 


__46. Select Window->Customize Perspective... 






New Window 











New Editor 
Hide Toolbar 
[RS Project Explorer 3% 

D MobileMedicalRecords TestApplication Open Perspective > 
ih JRE System Librayy {'e6] Show View , 
> B serverfjava 
> BA JavaScript Resources 
> © adapts 
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__47. Select the Command Groups Availability tab. 
__48. Select the check box next to Android SDK and AVD Manager. 
__49. Press the OK button. 





Too! Be Vsbilty | Menu Vist [ Commena Groups Avalabiigy] Shortcut 


Select the command groups that you want to 2ee added tothe current perzpective (lava EE), The detail field identifies which menu items 
‘and/er toolbar items are added tothe perspective ky the selected command group. 





Available command groups: Manuber detail: Toolbar detail: 


7] Android Lint * 
Andro Refactacings 








|) | [ex anerota sox and vo Manoaey 


Anco Wass 

IZ Annotation Navigation 

J] || art tttor Presentation 

1 | Beeskpoits 

7] Chest sheets 

W | | oh (Conveit Line Detiiters 
nas 

1 Debug 

Ector Nevigtion 

Hy Eutor Presentation 

1 External Tools 

aot 

TE GitNevigation Actions 


Java Bronsing Task Conte = 
a 
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__50. In the Worklight studio select Window-> Android Virtual Device Manager. 





File Edit Navigate Search Project Run Help 











mis | 8B of @~ New Window 
+ E~%o-~ New Editor 
._.. >; Hide Toolbar 
[& Project Explorer 3% = 
|| 4 2 MobiteMecicalRecords TestAppication | Open Perspective » 
\ i JRE System Library ireS] Show View , 
B server/java 
ad eoascnpaneciunes Customize Perspective. 
} > & odopters Seve Perspective As. 
4S apps Reet reereinee 
ie —— od Close Perspective 
] apps-backuy ee 
| in Close All Perspectives 
& components a 
avigation > 
> server 
> EE MobileMedicalRecords TestApplicationT| (Android SDK Mar 
| > Worklight Development Server 8 
| Web Browser > 
Preferences 
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__51. Select the TestPhone virtual device. 


__52. Press the Edit button. 








‘Android Virtual Devices | Device Definitions 











List of existing Android Virtual Devices located at C:\Users\admin\ android\avd 





AVD Name Target Name Platform __APlLevel__CPU/ABI 
FTestPhone Android 4.2.2 422 a7 "ARM (aimeabi-v.. 

















¥ Avelia Android Virtual Device. © A repairable Andro Viral Device. 
36 An Android Virtual Device that failed te load, Click ‘Detail to cee the e 
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__53. Examine the virtual device. No changes are necessary. 


__54, Press the Cancel button to exit. 


Tinos ea OS 











noMme 
ee 
|| Target: Android 4,2.2 - API Level 17 Zi 
CPU/ABE [ARM (ermeabi-v7a) 
ee No 














Freed Career a Nan = 
psckcomen: (Rene | 
Memory Options: | pam: 512 ~~ VMHeap: 48 
pee 
Sie 
|[Bevees) 

ee 





Snapshot [F]Use Host GPU 


(loverride the sisting AVD with the ssme name 
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__58. Exit the Android Virtual Device Manager. 


naienbee hen 


‘Anceoid Virtual Devices | Device Definitions! 








Q 

















List of existing Andrcid Virtual Devices located at C:\Usess\admin\.android\avd 





AVD Name Target Name Platform © APILevel © CPU/ABL 
VTesPhone Android 42.2 422 uv ARM (aimeabi-v. 


ih 


Repair. 

















& Avalid Android Virtual Device, [2) A repairable Android Virtual Device. 
3 An Android Virtual Device that filed to load. Click ‘Details’ to seethe error. 
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__56, Select the MobileMedicalRecords_TestApplicationTestApplicationAndroid project. 


__57. Press the right mouse button. 


__58, Select Properties from the menu. 





File Edit Navigate Seerch Project Run Window Help 
rte | & #@O- 
re eros 








> $i) MobileMedicaRecords TestApplcation 
> {ga! Mobile MedicalRecords TestApplicationTestApplicationAndr 














|: MobilemedicalRecorés_TestApplicationTestApplicationAndreid 





TB Project alee 5] esis "|e 


BE 


Gott 
Showin 


Copy 

Copy Qualified Name 
Paste 

Delete 

Removetrom Context 
Build Path 

Refector 


Import. 
Bport. 


Refresh 
Close Project 
Close Unrelated Projects 


Validate 
‘Show in Remote systems view 
Run As 

Debug As 

Profile As 

Team 

Compare With 

Restore from Local History. 
IBM Aoplication Center 
Android Tools 

Configure 


Source 


Alte ShitteW > 


cree 


trey 
Delete 
Ctit+AteeShitts Down 

AlteShifteT + 


AltsEnter 
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__59. Select the Run/Debug Settings tab. 


__60. Press the New button. 














|) pe iter tot 
» Resource 

Andris 

Andicil Lit Preferences 
Builders 

Java Build Path 

Java Code Style 

Java Compiler 

Java itor 

Javado: Location 
Project Facets 

Project References 





"Taee Reportary 
Task Tags 
Validtion 
viiTed 


“This page allows you to manage launch configurations associated withthe curently selected vesource, 
Launch configuration: for MobileMedicaiRecords.TestApplicatonT estApplicationAndrok 
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(a Lara) 
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__61. Select Android Application as the type of configuration to create. 


__62. Press the OK button to continue. 


Select Configuration T,. ===) mea) 


Sclect the type of configuration to create: 










Jo Ancrod Unit Tet 
Tu dUnit 

ilava Applet 
Tllava Application 





® oma 
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__63. Enter TestPhone as the Name. 


__64, Press the Browse button next to the Project name field. 














Saas 
|| name| 
SAndvwid| BI target common, 
es 
= 
Apply Revert 
2 To] 
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__65. Select the MobileMedicalRecords_TestApplicationTestApplicationAndroid project. 
__68. Press the OK button. 





((eapPree Seiccicn l=. 





Please select a project to launch 








MobileMedicalRecords TestApplicationTestApplicationAndr 











| @ x] ene | 
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The selected Project should be visible. 
_67. Select the Target tab. 

__88. Select the TestPhone check box as the preferred Android Virtual Device for deployment. 
__69. Press the Apply button. 


__70. Press the OK button. 





Edit launch configuration properties 


Android Application 





Name Testohone 








Always prompt to pick device 


© Launch on all compatible devices/AVD's| 
‘Active devices and AND’ 

( Automatically pick compatible device: Aways uses preferred AYD if set below, leunches on compatible device/AVD otherwise 
Select spreferres Ancrid Vinal Device for eeplayment: 





Target Name Platform APLLevel——_CPU/ABL Der 
“Android 63 ‘433 Fl ‘BM armecbievias") 











[Manager] 





Emulator launch parametes 
na compatible and zctve devices or AVD's are found then an AVD might be launched. Provide option: forthe AVD launch below. 
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__71. Press the OK button. 






Andreid LintPreferencer 
Buller 
Java uid ath 
lava Code Style 
lava Compiler 
p lava Eetor 
Javadoc Location 
Project Facets 
Project References 
Rur/Debuy Settings 
Task Repository 
Task Tess 
Validation 
Wrest 














Run/Debug Settings 











ae 





This page ellows you to manage launch configurations associted withthe curently selected resource, 
Launch configurations fer MabilaMedicalRecards_TestapplicationTesApalicationAndraic’ 
PitesProne 














(oe cee 
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The Android emulator uses a lot of memory. At this point the Integration Toolkit and the Integration 
Explorer should not be running, If they are running please close them. 


__72. Select the MobileMedicalRecords_TestApplicationTestApplicationAndroid project. 
__73. Press the right mouse button. 


__74, Select Run As-Android Application from the menu. 





$5) Eprepenie ) © 


23 Nobieesia Recor Tetophcaion cotte MobileMedictionAndr 
BA IESypem Libary] 
B senerine Shen Ashi» Rescue Pp Vaie 
1B nase Reouces . = 
= une nto 
2B apes ieee ‘ee 
ot MobieteieaRecors e 












fd) MobiebeicaRecoesaml e coy 1 Novem 
[a MotieMeicaRecerds ep Dace Dele alee 
cd Buia Pat . Hess 
EE Texdpptaion rie oe 1 Mil 
Seppe tedp 1 Mabie 
Sein 
© components 
5 sever 
 [S Nebitleiatecs 5 
bee Project 
(ese Unread Projets 
Eoin Dabue As +) 2Aado Tun Tes 
An outines not alibl Proilebe +) BE me Appat Peery 
Toa +) dime dppleaion eshte 
Compare Wn + ae Shite Me ShReXT 
estore tomLocl Hetaryn 


Fun Confguationse 





‘A message should appear on the console confirming that the build of the application was successful. 










x | ETE) ot Be ray = 
Serinaes>changelerearp [Bale Cute Warighlwevpae Mobiles, Tetpplesio app etipicar eniad nae eteaiTouldes wp 





suildfite: c:\shudent ert ight worksonceVnbiletndicslRecords Testipelication\anae\rertagl ica ion\android\nat ive. externa tonal 
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The Android emulator should start. It will take quite a few minutes for Android to boot up. The emulator is 
large and slow. 


(S554 Androiee (eer 


000 
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‘Some time after the emulator starts a pop-up dialog should appear. This might appear behind the 
emulator window. 


__75. Select the Yes, monitor logcat and display logcat view ... radio button. 
__76. Press the OK button. 


4a EEE 


Auto Monitor Logcat 


Would you like ADT to automatically monitor logcat 
output for messages from applications in the workspace? 














2.No, do not mo 
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Wait for the emulator to finish starting up. It is large and slow, so please be patient. 


__77. Select the GetLabResults button. 


Operations 


GetPatientHistory 


FindPatientMRN (onc) 
L / 


GetVitalSigns ARDoOe 


fi f2[ae(a-|s:leol7-la [oor] 
lq lwfe de [ny lula fo [e| 
id 


lea i 
eee 
y=) ce eames ad ed 


RequestTest 


GetMedications 
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__78. Click in the text box next to MRN: 


od Parameters ‘invore™ 
GetLabResults 


‘I 


ARDeOA 


fa fo fa fs foo fo fs Jo 
ila end 2 lic 


Perera 
ohagieeleememeene cael od 
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__79. Enter 12345 as the medical record number (MRN). 


__80. Press the Invoke button near the top of the display. 


GetLabResults 


MRN: 





The results will be displayed. If desired return to the main application menu and try some of the other 
options. 


__81. After examining the results the emulator should be closed. 





Sa 





G ss54TextPhone 





Baste Cont 


000 


area Buttons 


64000 


ware Keyboard 
our py sical keyboard to provide input 
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6.5 The Resource handler mobile pattern 


Use this pattern to provide services to mobile applications that use the Worklight APIS. The services are 
exposed to mobile applications as Worklight adapter procedures that are invoked from the JavaScript in 
the application. 


The pattern is customized by implementing handlers for each of these procedures as subflows in IBM 
Integration Bus. The pattern provides security policy enforcement and global caching. 


The pattern provides a reference implementation in the generated subflows, which can be used to 
construct a basic mobile example. This section will show you how to use this; specific configurations for 
user scenarios are left as an exercise for the reader. 


This example will use a “Mobile Cars” scenario, where car details can be added to a database (emulated 
by a shared memory area in Integration Bus). The details can then be retrieved from Integration Bus. The 
retrieve operation will first attempt to retrieve the information from the global cache. If not available from 
the cache, the details will be retrieved from the database (shared memory), and added to the cache for 
future retrievals. 
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1, Return to or start the Integration Toolkit. 


2. Select the Patterns Explorer tab. 


4. Select the Resource handler pattern. 





> Gi Application Integration 
File Processing 

> Gil Healthcare 

Message-based Integration 

Microsoft [NET Integration 






MessageSight 
28 Event Filter 

Event Notification 

4G Worklight 

Microsoft NET request-response 
Mobile service 


Resource handler 


Service Er 
Service Virtualization 





omMQ 











3. Scroll down so that the Mobile>Worklight category is visible. 
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‘Take some time to read about the pattern. 
5. 
Hembree ai 
% View Pattorn Spacatieation 

‘View infrmation sat the secs paen ante cc thst Tees ton o fet sto ng pate . 


Click Create New Instance. 

















Worklight: resource handler pattern 


Use this pattern to provide services to mobile applications that use the Worklight APIs. The services are 
exposed to mobile applications as Worklight adapter procedures that are invoked from the JavaScript in the 
pplication 


‘The pattern is customized by |mplementing handlers for each of these procedures as subflows in WebSphere 
Message Broker. The pattem provides security policy enforcement and global caching, 











oie Doves 
0 nigh Websphere esse Broker 
Sopa Tin Rar a Pa rae 
i= 
> || = Seo 
Cy ets, 
gq 



































Aaterienien ES | 
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__6. Enter MobileCars as the Name. 


__7. Press the OK button to generate the pattern instance. 


ee ea 


Create New Instance wo 














‘The initance nome inipicly identifies the paitem instance pot thats created when the patie instances 
saved or generated. The name ideally reflects the business and integration functions thatthe pattern supports. 








Pattern instance name: 
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The pattern parameters editor should open. 
_8. _ Expand the Worklight section, 


__9. _ Remove the selection from the Enable audit check box. 








ae Se] paieanan 
Adapter descriptor Vioright integration acaptes lessen 
al = 
> Security LDAP! s 
> Legging - 
1 Krror handing s 
+ General a 


__10. Collapse the Worklight section 
__11. Expand the Service Configuration section. 
__12. Enter Car as the Resource name. 


__13. Select the Cache results check box. 





Configure Patorn Paramore 
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__14. Collapse the Service Configuration category. 
__1. Expand the Logging category. 
_16. Select the Logging required check box. 





Conte Pattern Parameter 


men Ponte: Sw | Remnant 
ve Oy 
nd a aS 
a) . 
a | feces 
e 














__17. Collapse the Logging category. 
__18. Expand the General category. 
__19. Enter CARS. as the Queue prefix. (N.B. remember the period at the end of the prefix.) 


20. Click Generate to generate the pattern. 





"% Contgue Paton Parametars 





atone: EGS | Pontoons 
Vise OT is 
Vern @ 0% 
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__21. Close the MobileCars — Pattern Configuration tab. 





__22. Close the Pattern Specification tab. 





The message flows use a couple of MQ queues. The queues will be created next. 


__23. Either return to or start MQ Explorer. 





__24, Expand Queue Managers->IB9QMGR. 
__25, Select the Queues folder. 


__26. Press the right mouse button. 


__27. Select New>>Local Queue from the menu, 










Message Source 





‘Alias Queue. 
Model Queve.. 
Remote Queue Definition. 





 Listene! Object Authorities. > 
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__28. Enter CARS.LOG as the Name of the queue. 


__29. Press the Finish button to create the queue. 


New 





Create a Local Queve 


Ente the details of the object you wish to create 





Name: 





‘Select an existing object from which to copy the attributes for the new object: 
SYSTEM, DEFAULT.LOCAL QUEUE 


When this wizard completes, another wizard can be started automatically to createa matching object. 
Fi Start weard to createa matching JMS Queue 



































_30. Press the OK button to dismiss the dialog box. 


"@ IBM Websphere MO (cn) 





i) ‘The object was created successfully. (AMQ#148) 


{do not show success messages in future 
(To re-enable, goto the MQ Explore: preferences) 
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__31. Select the Queues folder. 
__32. Press the right mouse button. 


33. Select New>Local Queue from the menu, 








MQ Explorer - Content | Administration 


Message Source x 














‘Alias Queue. 


Model Queue... 
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__34, Enter CARS.ERROR as the Name of the queue. 
__35. Press the Finish button to create the queue. 











Create a Local Queue 


Enter the details ofthe object you wish to create 





Name: 





Select an existing object from which to copy the attibutes for trenew object. 


SYSTEM.DEFAULT.LOCAL QUEUE 





When this wizard completes, another wizard can be started automatically to create amatching object. 
[Tstar wisardto create 2 matching IMS Queue 




















@ 2a (ati = 














__36. Press the OK button to dismiss the dialog box. 


“CS omnaspheene Slee 








i) ‘The object was created successfully. (AMQ#148) 


[Ho not show success messages in future 
(To re-enable, goto the MQ Explore: preferences) 
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__37. Minimize MQ Explorer. 
_38. Select the MobileCars_RestApplication application. 
__39. Press the right mouse button. 


__40, Select Deploy from the menu, 





Focus on Application 


BB Convertto Libray 


‘Application Develo 
ms aa Export XSDs from Application 





> Gl Pattern Instances; 
» | Mobiles RESTApplication| Migrate 
> BA MobileCars ProcedureHandl 
44 [D) Independent Resources 

2H MobiteCars WorkightAd} Copy 





Golnto 


Paste 
Delete 
Move.. 


Impor.. 
Export.. 


BE 


Refresh 


Build for mgsipackagebar 
Test 
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__41, Select the default integration server. 


__42. Press the Finish button to initiate the deployment. 











@ Depry 


Deploy 
Select integration server to deploy selected resources. 











«4: By Integration Nodes 
4 &i IBONODE 




















@ ere | ee 


The deployed application should be visible in the Integration Nodes view. 








‘Eg Integration Nodes 2% BE Outline) Z) Tasks) go75) 
“4 dig Integration Nodes 








4 & IBONODE 
> @ Configurable: 
4 & default 
> il MobileCars RESTApplication 
> &l MobileMedicalRecords, DotNetServiceApplicationFlows 
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6.6 Install and test the MobileCars adapter 


__1, Either return to or open the Eclipse Workbench for Worklight, using the icon on the main window. 





__2. Select the C:\student\Worklight\workspace directory. 
__3. _ Press the OK button to open the workbench. 
Workspace a) 


Select a workspace 





IBMG Worklight Studio stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session, 


Workspace: C:\student\Worklight\workspac= 





VWs vices the cetanlem cian notack sea | 
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In the Project Explorer point to a blank space. 


Press the right mouse button. 





Select Import from the menu. 





[& Project Explorer 5% Copy Qualified Name 
> 9B MobileMedicalRecords TestApplication| (5) Paste Ctriev 
|i MobileMedicalRecords TestApplication| 3¢ Delete Delete 
ba ERSGRE Deoetopenvent Server Remove from Context Ctrl+ Alt+Shift+Down 
Za build Path , 
Refactor AlteShitteT > 
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Expand the General folder. 





__8. Select Existing Projects into Workspace. 


__9. Press the Next button. 











Create new projects from an archive file or directory. Ey 





Select an import source: 


typefittertet 











4 & General z 





©) Preferences 
> & Android 3 
> & cvs 
> SEB 
> & Git 
> © Install 
> © Java EE 
> G Plugrin Development. 
> & Remote Systems 
> @ Run/Debug 
5 Ga Tacke 


























® ce 


Finch | [aaGaneel 
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10. Press the Browse button next to the Select root directory text box. 





|| Import Projects 


Selecta directory to search for existing Eclipse projects. 


Sz 





@ Select root directory: | 








OSekctarchiveric | 


Browse. 





Projects: 








Select All 
Deselect All 











‘Copy projects into workspace 
Working sets 





dd project to working sets 


Working sets | 


=| see 
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__11, Navigate to the C:\student\mobile\workspace\MobileCars_WorklightAdapter project. 
12. Press the OK button. 


Browse For Folder ==) 


Selectroot drectory of the projects to import 











Dy GeneratedBarFies = 
> Ut Mobitecars 
(Ui MotiteCars ProcedureHandlers 
[i MobileCare_RESTApplication 














Folder; MobleCars, WorkightAdepter | 


a ee | 


———=s) 
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13. Select the Copy projects into workspace check box. 


14. Press the Finish button to start the import. 














Import Projects = 
Select e drectry to search for eitng Eclipse projects. 

“ad 
@ Select root directonz Ci\studentimobie\workspacc\MobileCors WorkightAdapter Browse 
(OSelectarchivefile | [Bewsen 
Projecte 


[Z| MobileCars. itAdapter (C:\student\mobile\workspace\MobileCar 











Working sets 





(id project to working sets 


Working sets x} [__ Select 











Cancel 
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16. 

16. Select the MobileCars.xml file. 
__17. Press the right mouse button. 
_18, 


Expand MobileCars_WorklightAdapter->adapters->MobileCars. 


Select Open With Adapter Editor from the menu, 





1 &D Meblecars WorightAdaper 
DA JRE System Library je] 





> GS serverjave 




















New > 
mh JavaScript Resour 
4 & adapters showin ‘Akeshinew > 
Open B 
(iMobieCarsama Open with » | ty [Baspter cater 
0 enican) —oP u 
ine glow ceiuc || Androl Common XML Eitor 
> & apps-backup 3 Copy Qualified Name IE) ene Ee 
> &bin ae criey |B MLEAitor 
> sener 
__19. Examine the contents of the adapter XML file. 
__20. When finished close the editor. 
=a 
Adapter Editor 
Overview Details = 
pate feioak.’ (ia 
“a Ub Adapter *"MobileCar™ Domain’ localhost 
+  Conectviy Pods 780 


[] Connection Palicy| 
® Procedure 
@ Procedure “eleteCar’ 
@ Procedure ‘readCar" 





® Procedure "updateCar’ 





Cooke policy: [BESTMATOH 


Sete how the HTTP adapter handles cookies aving from the back-end 
application 

















10 

‘The maximum number of redirect that the HTTP adapter should 
fellow. This iz useful when the back-end pplication sends circular 
recrects as 2 result of some eror such as authentication feilures. The 
dlefouitvalueis 20 


Mas resect 
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__21. Double click the MobileCars-impl.js JavaScript file, 





— 
paaipean 
oan 
oer 
4 adapters 
4 @ MobileCars 
——— 
[como 
@ apps 


__22. After examining the JavaScript file close the editor pane. 





© Metilecersimpliq(s2] 


0 
ir 





function createCer(paraneters) { 
FueroWane = "Create’s 

far bodystring = paraneters: 

NL Logger. debug("createcar 

var envelope = "{ "envelope 





+ bodystring); 





iL .Logger.debug("“createCar sending 
var input - { 

metaod © ‘past’, 

path: ‘/car', 


4 envelope) 


body: { 
ContentType : ‘applicatLon/json; cherset=utt-~ 
content : envelope 





1 
Pe see taney 
+ 


SH readcar(id) { 
Logger.debug("reedcar : * + Ld); 


wat = { 
wethod 3 Tart" 
pata: "/car' 4 °/ 4 48, 











body: { 
contentType 
content : [] 





application/json; charset=utf-3", 


? 


b 


return WL.Server. invakeitttp(énout) s 


? 


{theader* : { "verb" : *' + verbtleme + '* }, "body" = 


"+ bodyst 
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__23, Select the MobileCars adapter. 


__24, Press the right mouse button. 


__25. Select Run As>Deploy Worklight Adapter from the menu. 








[Serejar epirer 
4 Mebiecare Werks 
JRE System Libr 
Bi anerjae 
1 lavaSerpt eco 
oper 


MobiteCare| 
[el Motiter 9g 
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© apps backup 
Shin 
sere 
» $B Mobichtecicaec 
>  MobiieMedicaRec 
E Werk ghe Develops 


a 








Weta Conse 








Paste 


Seerey 
Build Path 

Move 

Rename, 

Import. 

por. 

Refresh 


valicate 


Shaw in Remote Systeme view 





Dabug Ar 
Profile As 


Team 





([EC Makers | Propetes| fk Servers [BE DataSource Explorer] ES Snippets | Console 52 





lee ShifteW 


isc 


cue 
Delete 





te Shits Down 


Cy 


5 


»/ @ Bepley wenstgreasaprer] 
» |e Zinvoke Worcight Back-end Service 
> 4 3nvoke Wotkight Procedure 





The results of the adapter deployment should be visible in the console view. 


28. Confirm that the adapter deployment was successful. It may be necessary to select the 
Worklight Console as the selected console, using the icon highlighted below. 











3 00:21:08) | 
a8 09:41:08 











Start a Google Chrome browser session. 


__27. Double-click the Chrome icon. 
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28. Navigate to http://localhost:8080/console. 








29. Expand the Show details area. 









Y wna couse 
seco. acu as 









| = ee 


The procedures in the installed adapter should be visible. 








30. Minimize the browser session. 
YG vest cane Sl ld == 1 — 
©. > © Dlocatostsne0/onsoiernsexrimizetiog 2 

‘Welcome, Gusst|Loamut [About 





IBM Worklight Console 


Dette 





Lestussaeo st araarzate 
\Woroiagraten asa 
Probe to 
7a 


1 aC calor 











Page 291 





Lab 6 - Working with mobile applications 


_3t 
_32, 
_33, 
_34, 















New > 
> BA JavaScript Res 
4 & adapters SENS 
« Gisbiecee showin Ake ShifteW > 
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Return to the Worklight studio 
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Press the right mouse button. 

Select Run As Invoke Worklight Procedure from the menu. 
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The Worklight test client should open. 


__35. Use the drop-down menu to select createCar as the Procedure name. 





Edit configuration and launch. 











Name: Invoke Procedure MobileCais. WorklightAdapter - MobileCars 








Prjet ame: [Mobis Werkitdntr —| 
Adapter ume: (MobieCans 














Procedure name: 








Signature: 
|||) crestecar[paramezers) 


Parameters (comma-separated: 
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The data for this procedure is available in the C:\student\mobile\data directory in a file named 
volvo.txt. The contents of the file can be copied and pasted into the Parameters field. 

_36. Enter "{\"Car\":{\"Make\"\"Volvo\",\"Colour":\"Red\"})" in the Parameters field (N.B. string 
values are enclosed in double quotes so the double quotes are part of the input). 


__37. Press the Run Button. 





Name: Invoke Procedure MobileCars Work ghtAdaptet- MabileCars 
Invoke Procedure Data| 


Project name: [MobileCars WerhlightAdspter 


‘adapter name: | MobleCare 








Procedure name: cresteCar 





z] 
Signature: 


tresteCat (parameters) 


Parameter (comma-s 
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The Worklight test client will invoke the MobileCars Worklight adapter, which in tum will invoke the 
message flow. 


The Test Client will show the value that has been returned from the Integration Bus application when the 
createCar procedure is invoked. In the example below, this shows a result of 1 for the ID field. 


__38. After examining the results close the Invoke Procedure Result window. 


@ Invote Procedure Resulf ea] 
Invocation Result of procedure: 'createCar’ from the Worklight Server: 











ul": true, 

NzesponssHeaders": ( 
"Content-Length": "10", 
"Content-Type": "application\/json;charset=utf-8 
"Date": "Thu, 18 dul 2013 04:43:55 GMI", 
"Server": "Rpache-Coyote\/1.1" 
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Assecond and third car will be added next. 


__39. Select the MobileCars adapter. 


__40. Press the right mouse button. 


__41. Select Run As>Invoke Worklight Procedure from the menu. 















> (BE cenveniava 

> mi JavaScript Res 

4 & adapters 
MbileCers 

ci Motte 

B Mobile 

& apps 

CS appr-backup 

> & bin 

> @ sener 

> 2 MobieMedicaRec 

> $3) MobileMedicaRec 







EE Outline 53 
‘An outlines nat available. 








4 8} MobileCare WorklightAdapter 
> Bh JRE system Library Ure] 





oor 





New » 
Go into 

Shown ‘Alte Shift-W/ > 
copy Ctrlec 
Copy Qualified Neme 

Paste cere 
Delete Dekete 
Build Path » 
Move.. 

Rename.. R 
Import. 

Epport.. 

Refiesh 5 








»] @ 2 Deploy Workight Adapter 





Run Configurations 





Page 296 


Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


The data for this procedure is available in the C:\student\mobile\data directory in a file named 
volkswagen.txt. The contents of the file can be copied and pasted into the Parameters field. 


_42, Enter "{\"Car' 





'Volkswagen\",\"Colour\":\"Blue\"}}" in the Parameters field (N.B. 
string values are enclosed in double quotes so the double quotes are part of the input). 


__43. Press the Run Button. 


Edit Configuration bg 





Edit configuration and launch. Gg 








Name: Invoke Procedure MobileCars WorklightAdapter - MobileCars 


Project name: 











[MobileCars WorklightAdapter 
Adare noe: (acai 














Peete aaa 





Signature: 
fereateCar (parameters) 





Parameters (comma-separated): 
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The Worklight test client will invoke the MobileCars Worklight adapter, which in tum will invoke the 
message flow. 


The Test Client will show the value that has been returned from the Integration Bus application when the 
createCar procedure is invoked. In the example below, this shows a result of 2 for the ID field. 


__44, After examining the results close the Invoke Procedure Result window. 





@ Invote Procedure Resulfsa] 4 
Invocation Result of procedure: 'createCar' from the Worklight Server: 








ful": true, 
"zesponseHeaders™: { 
"Content-Length": "10", 
"application\/3 
"Thu, 18 Jul 2013 04:46 
"Server": "Apache-Coyote\/1.1" 
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A third car will now be added. 


__45, Select the MobileCars adapter. 


__46, Press the right mouse button. 


__47. Select Run As>Invoke Worklight Procedure from the menu. 
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The data for this procedure is available in the C:\student\mobile\data directory in a file named 
vauxhall.txt. The contents of the file can be copied and pasted into the Parameters field. 


_48, Enter "{\"Car' 





'Vauxhall\",\"Colour\":\"Green\"}}" in the Parameters field (N.B. 


string values are enclosed in double quotes so the double quotes are part of the input). 


__49. Press the Run Button. 








Edit Configuration a 








Edit configuration and launch. 








Name: Invoke Procedure MobileCers WerklightAdapter - MobileCars 











Project name: —[MobieCar WorkightAdeper 5] 








Rees [PP 








pee aaa 





Signature: 





|creeteCar (parameters) 


Parameters (comma-separated): 
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The Worklight test client will invoke the MobileCars Worklight adapter, which in tum will invoke the 
message flow. 


The Test Client will show the value that has been returned from the Integration Bus application when the 
createCar procedure is invoked. In the example below, this shows a result of 3 for the ID field. 


__50. After examining the results close the Invoke Procedure Result window. 





| @ tnvote Procedure ResulffS2] i 


Invocation Result of procedure: 'createCar' from the Worklight Server: 
1 








lal": true, 

"zeaponssHeaders": ( 
"Content-Length": *10", 
"Content-Type": "application\/json;charset=utf-E! 
"Date": "Thu, 18 Jul 2013 04:48:31 GMT", 
"Server": "Apache-Coyote\/1.1" 
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The next part of the lab will retrieve two of the car objects that were created in the previous steps. 


__51. Select the MobileCars adapter. 


__52, Press the right mouse button. 


__53. Select Run As>Invoke Worklight Procedure from the menu. 
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__54. Use the drop-down menu to select readCar as the Procedure name. 
__55. Enter 1 in the Parameters field. 
__56, Press the Run Button. 


Edit configuration and launch. 








Name: Invoke Procedure MobileCars WorklightAdapter - MobileCars 


“Invoke Procedure Data, 


Projetname: _(Mobistas Woighthdenen | 

















gee: = =| 


[ea] 





Procedure nam: 





Signature: 
lreacCar (a) 





Parameters (comma-separated): 


Ea] 2 











Apel 
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The Worklight test client will invoke the MobileCars Worklight adapter, which in turn will invoke the 


message flow. 


The Test Client will show the value that has been returned from the Integration Bus application when the 


readCar procedure is invoked. 


__57. After examining the results close the Invoke Procedure Result window. 


@ Invoke Procedure Resulf BE ] 








Invocation Result of procedure: 'readCar' from the Worklight Server 


| [orcaze: ¢ 
"Colour": "Red", 
"Make": "Vvoivo" 








responseHeaders' 
"Content-Length": "39", 
"Content-Type": "application\/json;charset=utf-8", 
"Date": "Thu, 18 gul 2013 04:50:11 GMT", 
"Server": "Apache-Coyote\/1.1" 
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Assecond car abject will be retrieved next. 


__58. Select the MobileCars adapter. 


__59. Press the right mouse button. 


_60. Select Run As>Invoke Worklight Procedure from the menu. 
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__61. If necessary, use the drop-down menu to select readCar as the Procedure name. 
__62, Enter 3 in the Parameters field. 


__83. Press the Run Button. 





























W) Edit Configuration Ls J 
Edit configuration and launch. Gg 
Name Invoke Procedure MobileCers. WorklightAdapter - MobileCars 
Prokctrame | MMaticCorsMetaadsptey =| 
‘Adaptername:  [MobileCars x] 








Procedure name 








Signature: 
\readCar (id) 





Parameters (comma-separated): 


























® a 
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The Worklight test client will invoke the MobileCars Worklight adapter, which in turn will invoke the 
message flow. 

The Test Client will show the value that has been returned from the Integration Bus application when the 
readCar procedure is invoked. 


__64. After examining the results close the Invoke Procedure Result window. 


@ Invoke Procedure Resulf sa] 
Invocation Result of procedure: 'readCar' from the Worklight Server 
1 











Tasuccesstal? true, 
"responseHeaders": { 
"Content-Length": "44", 





“application\/json;charset=utt- 


Content-Type": 
1:26 GMT", 


"Thu, 18 Jul 2013 0: 
"Apache-Coyote\/1.1" 






__65. Close the Worklight studio. 





ie Gar fescer Ngee Sen Font Wns ee 
- 68 > Sea a o> Oe 








Es 














ow nigh 
|] “ates os 

Basen te Tne 
Page 307 





Tab 6 - Working with mobile applications 


66. Press the OK button to confirm the exit. 
ee 
e Exit application? 


Always exit without prompt 
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Clean up 





In the Integration Nodes pane of the integration toolkit expand the IB9NODE entry. 
2, — Select the default integration server. 


Press the right mouse button. 





Select Delete>All Flows and Resources from the menu. 













«4 Big Integration Nodes 
«i IONODE 
> Qe Configurable Services 


= —t 
Launch Debugger(Portis14aga) | %_Ilegration Sever 


5. Press the OK button to acknowledge the warning and start the deletion. 




















«4: ig Integration Nodes 
4 & IBSNODE 
> @& Configurable Services 


Sse 


This is the end of lab 6. 
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Lab7 Working with files 


7.1 Overview 


File processing is an important characteristic of an Enterprise Service Bus. (ESB). This lab will use one 
of the samples provided with IBM Integration Bus that shows how to read a large message and break it 
into multiple output messages (sometimes referred to as message shredding). 


The sample takes in a large message with a repeating structure. It then processes each repeating 
message individually and writes an individual message for each repeating element. Since there are ten 
repeating elements, the input will result in ten smaller individual messages. This message flow will be 
modified to accept the same input in a file as well as an IBM WebSphere MQ message. 


The techniques demonstrated in this sample flow show how very large files consisting of a large number 
of repeating segments can be processed efficiently, without requiring large amounts of memory. 


The following message flow will be built. 





al “at 


General Failure ~~ RepestedélementSlices 











ase yanensicingteCorpiete 
|e“ 
ProduceldeageSlcestromRepetingtements = 
ut “daik 





MezeageSiicingComplate 





cmenProcesing ~~ fa k 





Matforned messages 
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IBM Software 


7.2 Create the message flow 


__1. Select File->Switch Workspace>Other. 












Carle 


Ctrl+Shift+W 


Save Ctrles 


Save All Ctrl+Shift+S 


C\student\workspace 
C\student\ps\workspace 
‘CAstudent\labmaterials 
C\student\wsaddr\workspace 
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__2. Press the Browse button to select the workspace. 
Sa 


Select a workspace 
WebSohere Message Broker Toolkit - Message Broker stores your projects in a folder called a workspace. 


Choose a workspace folder to use for this session, 

















Workspace: Ci\student\workspace 


> Copy Settings 








@ 











__3. Navigate to the C:\student\Files\workspace directory. 
__4. Press the OK button to select the workspace for this lab. 
[ select Workspace Directory leon) 


Select the workspace directory to use, 








aD Fis 





J) Into XML_Message 
>) IKE Client 





|] rote; wortsnace 


|) Gono) a Ge 
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Press the OK button to open the integration toolkit. 


IBM Software 





Workspace Launcher 











Select a workspace 


Choose a workspace folder to use for this session. 


Workspace: 





> Copy Settings 





WebSphere Message Broker Toolkit - Message Broker stores your projects in a folder called a workspace. 














Select the Samples icon hotspot. 





BM Integration 


e) 


Got Started Samples 











ji 


Go tothe imegraton Totkit. /=} 


+ { 


Returning Users Web Resources 
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__7. Close the Welcome tab. 


_8. Double-click the Samples and Tutorials tab to open the samples in full-screen mode. 


(eer 


__9. _ Expand the Application Samples. 


__10. Click on the Large Messaging sample item. 
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IBM Software 


‘Anew window should open. 


__11. Select the Import and deploy the sample option. 
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An Import and deployment summary dialog should appear. 


__12, Press the Next button to import the sample project, create the queues and deploy the message 


flow. 


aT 


Import and deployment summary 
To complete the following tasks, click "Next": 











[Bummary of tasks: Message Broker Large Messaging sample 2 


|| (Create the following projects in the workspace: 
|| LergeMessaging 


|Add the following WebSphere MQ queues: 

|LARGE_MESSAGING_IN 

|LARGE_MESSAGNG sLicIG_ COMPLETE 

[Lance Messacn suces | 
|LARGE_ MESSAGING MALFORMED, MESSAGE 

[LARGE MESSAGING ERROR 


Deploy the samples into the following new execution groups: 
|LargeMessagingExecutionGroup 


|| Warning: This vill overwrite any existing resources that have the same names, 





® Beak Fah 
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__13. Scroll down and confirm that all the tasks were successful. 
__14. Press the Next button to continue. 


Import and deployment progress 


inp and dems cmp 


[Creating the WebSphere MQ queues: LARGE MESSAGING MALFORMED MESSAGE 
Ihe task succeeded 











\Creating the WebSphere MQ queues: LARGE MESSAGING ERROR | 
‘The task succeeded } 


Creating the new execution groups and deploying the samples: please wait. 
“The task succeeded 


|The task succeeded 


All tasks were completed successfully. l 


‘ 








| (cesta 











® Back f= 























IBM Software 
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IBM Software 


15. 


Press the Finish button to dismiss the dialog. 








Sample successfully imported and deployed 
CClick'Finish’ to close the wizard. 











|| [The sample was imported and deployed successfully. * 


Return to the help pages to learn more and torun the semple. 
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Take some time to read about the sample. 


16. Close the Information Center window. 
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IBM Software 


The imported message flow should be open in the message flow editor. 





















Nesogearinereamattherts 


eseaeteng-anpte 


= 


__17. Expand the File folder. 
18. Select the Filelnput node. 

19. Drag it to the canvas and press the left mouse button to add the node to the message flow. 
20. Change the name of the new node to Read File. 


21. Press the Enter key to complete the rename operation. 





4 Dror 
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__22. If the flow editor is in full-screen mode double-click the Read File node to display the properties. 
__23, In the Properties pane select the Basic tab. 


_24, Enter 





tudent\Files\Input as the Input directory. 


__25. Use the drop-down menu to select the Add Time Stamp and Move to Archive Subdirectory 
(mqsiarchive) as the Action on successful processing. 


fa rs EE eT] eEey, 


IB File Input Node Properties - Read File 
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__26. Select the Input Message Parsing tab. 


__27. Use the drop-down menu to select the XMLNSC parser for the Message domain. 
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IBM Software 


__28, Wire the Out terminal of the Read File node to the In terminal of the 
ProduceMessageSlicesFromRepeatingElements node. 





F 


RepestedElementlices, 








la la < 
cman ProducslsézegeSIicerFromRensatingElement: 
MessegeWithRepeatingEicivents beers eee 








of 


MezeageSiicingComplate 





Matforned messages 


One more change will be made to allow for a very large file. The processing of the sample is based on 
MQ messages and as such the output messages are part of a single unit of work. However, this would 
not scale to a very large file. The “repeated element slices” messages will therefore be written outside of 
async point. In a production environment this could lead to duplicate messages in the event of a failure. 
The duplicate messages could be easily handled by using a resequence node and putting a sequence 
number in the local environment. This would eliminate duplicate messages resulting from a failure. 


__29. Select the RepeatedElementSlices node. 
__30. In the Properties for the node select the Advanced tab. 


__31. Use the drop down menu to select No as the Transaction mode. 































perties F  [2. Problems| Ei Deployment Log| Pers 
2a ouput Node PropertsfRepenesrnen Se] 
j 
Description 
— a "] 
a Trensectonmode [Ne] 3] 
Votdaion | Psstencernce [Aut *] 
New message ID o 


_ 32, [PAPE save no message tow 


The message flow is now complete. It has been modified to accept files as well as messages as input. 
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7.3 Execute the message flow 


The message flow will be tested using both a message and a file as inputs. The message path will be 
tested first. The sample program includes a flow test with data. This will be used to test the messaging 
path. 


__1. If the screen is in full-screen mode double-click the message flow editor tab to return to 
windowed mode. 





__2. Inthe navigator pane, expand Independent Resources->LargeMessaging->BARs. 
__3. Select the LargeMessagingBrokerArchive.bar broker archive file. 
__4, Press the right mouse button. 


5. Select Build and Save Broker Archive from the menu. 























Application Develepment New. [TS \ 
a TBARS  Faverites 
(BB Large essagingbrokerchivebar St==amacina ill aa WebSohere MC 
New > 
Open 
Open With , 
‘Add Bookmark. 
by Import. 
1A. Bpot.. 
Refresh 
Generate Documentation. 
. 
189 [ build and Save Broker Archive 
Team » 





Page 322 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


IBM Software 


Press the OK button to dismiss the warning (if it appears). 


ID) override configurable pro 


You are bout to over the configura ropertissin the Broker archive 
fle, this option canbe changed n the Piepar® tab nthe Broker active 
editor usingthe verre configurable property values option, 





‘Would you Ike to continue? 


T po not show thiswarring again 








In the Project Navigator pane select the LargeMessagingBrokerArchive.bar archive file. 





Press the right mouse button. 





__9. Select Deploy... from the menu. 























‘Application Development New, 
4 (il BaRs 
(GB LargeMessagingBrokerArchivelbar > t=en-Kinensninnll none 
4 Indepegggfie Resources New > 
1 LaMeszaging a 
Open With > 
‘Add Bockmar.. 
iy Import. 
eA Expor 





Refresh 


Generate Documentation... 


Build and Save Broker Archive 
Team » 
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The import and deploy wizard created an additional integration server where it deployed the original 
version of the message flow. The updated message flow will be deployed to replace the original version. 
__10. Expand Integration Nodes->IBSNODE. 
__11. Select the LargeMessagingExecutionGroup integration server. 
__12. Press the Finish button to initiate the deployment operation. 
. - - = 
Orme 


| Deploy 
Select integration server to deploy selected resources. 























Hy Integration Nodes 
i IBaNODE 


\ default 
& LargeMeszagingExecutionGrovs 

















® nish, Cancel 


__13. In the navigator pane, expand LargeMessaging->Flow Tests. 








__14. Double-click on the SampleInputMessage.mbtest file to launch the Test Client. 


Rpananveopeat ji 
> wars 


4 (5) Independent Resources 
4 LargeMessaging 

2 Flows 

> est ESQLs 


.@nA 


LaigeMessagingBrokerArchivebar 
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Examine the test client window. The Enqueue entry should be selected. This will write a message to 
the specified queue. The name of the queue and queue manager is specified under Detailed 
Properties. The input data is shown in the large text box in the Message area. 


__15. Press the Send Message button to send the data to the specified queue. 
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The results of the execution of the message flow will now be examined. 
__16. Return to MQ Explorer. fit is not running start it 

__17. Expand the IB9QMGR queue manager. 

__18, Select the Queues folder. 

__19. In the right-hand pane scroll down so the LARGE_MESSAGING_ SLICES queue is visible. 
__20. Confirm that there are ten messages in the LARGE_MESSAGING_SLICES queue. 

__21. Confirm that there is one message in the LARGE_MESSAGING_SLICING_COMPLETE queue. 





Queues 


Filter: Standard for Queues 








7 Queue name Queuetype Open input count Open output count Current q 
i LASSTATE Local « 0 ° 
ty 43.u5.0UT Local « ° ° 
(Gl LARGE MESSAGING ERROR Local o o ° 
(Gh LARGE MESSAGING IN Local 1 o ° 
A A 0 
° 1 
a 1 
(AMAPACCTCLOSE Tocat T T 7 


The same test data will now be copied into a file and the file path will be tested. A Windows Explorer 
session will be used. 


__22, Select the Windows Start button. 
__23. Press the right mouse button. 


__24, Select Open Windows Explorer. 
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Navigate to the C:\studentFiles directory. 
26, Select the Files directory. 


Point to a blank area in the right hand pane and press the right mouse button. 


28. Select New->Text Document from the menu that appears. 

























































€p]f Seon Fes 
Orgense > Incledeinirany ~ Sharewith ~ New folder 

student Bl Nome 7 Date modified Type Size 
oe Wipe ernnni234s FM Flefoter 
He Bi otput Fleolder 
“Dota “B werispace Flefoider 
Eee (Dy Accountupatabtch inane 133 PM_ BATCHFie ake 
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\) DBROUTE Sub a 
Bore ee ‘i 

| han |g Fefech 
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Blerocesin 
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Baus ieee coz 

GD sertpace Sharevith » 
1 Heathcoe t 

New Faller 
tno 01.01 
(WAKE Client Properties pect 
“BE hen cee 
Does. Contac 
Peas Jovinal Document 
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Anew file should be created in the Files folder. 






























~18) Seo rls 
aa eda at =: oe 
Davia (6 Daerodiied Type soe 
| esi 9/20/20123:48 PM File folder 
Bi cono. : 
oyna 2m2 PM Fleder 
B con é 
Le gym 232 9 Fletlder 
Lrya09 413 Pl)_BATCH Fie ae 
) van06 
02691 AM Tet Downs oe 
Bowe 
i osroure | 


__29. Change the name of the new file to TestFilet. 
30. Press the Enter key to complete the rename operation. 


__31. Double-click the new TestFile1 file to open the file in the notepad editor. 


Name Duta cine | ype eo 
DB input 11/3/20121040 ..Filefolder 
Wi targerie 1113720121133... Flefolder 
DB output 9/21/2012547 PM File folder 
Di wotkspace 11/13/2012803 AM Filefolder 
D) AccountUpdate-batch 1/14/2009413 PM_ BATCH File 3ke 








- 11/13/20128:39 AM Text Document 10 kB] 
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A notepad session should open. The file is currently empty. The test data from the test client will now be 


copied and pasted into the notepad session. 

__32. Return to the test client in the Integration Toolkit. 
__33. Move the mouse pointer to the message text. 
__34. Press the right mouse button 


__35. Click the Select All menu item. 





Message 
> Header 





ody [EB as text a 


D1 Show in hexadecimal viewer (Read Only) 


FSdeGnvelope> Header > <SalelstComnt> 10<[sdelstCaunt> <Header> =] 
y>Euros<jCurency><jInvsice><jSalelist> <Salelist> <Invoice> <Intial>F 
co></Salelist> <SaleList> <Invoice> <lntialg<jintial> <Intia>2<jInial> 
Invoice> <n"), flal>gs/Intial> <Surname >tgcdraRGly < 









al>ainiaoni< U4? EerriakQliaar<ibumame> <ttem> <Cod 
trmamie>oRON b> <Item <Code>08 <Code> <Code>07 
me><Item><c tt ‘Code>07 </Code><Code>03</Code> <I 





Codeson</cor Cony 
ode><Descript paste 


lode > <Descrintion >sALIRpEI Descriptor 
scripbon> <catecory >bgHOl<jCategory? 














PDescription>< re Category><Price>50.44 </Frice><Quanl 
i oo 
Import Source. Send Message 
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__36. Move the mouse pointer to the message text. 


__37. Press the right mouse button. 


__38. Click the Copy menu item. 





Message 
> Header 





coy: [Ea ast 


Select Al 





D1 show in hexadecimal viewer (Read Only) 







tnitial>a 








itial><Intial: 
lntal> <Surname>rrkge 
name> <Item: 











Inport Source, 





Send Message 


__39. Return to the notepad session. 


40. Point the mouse in a blank area of the notepad session and press the right mouse button. 


__41. Select Paste from the menu. 





1 TestfleL bt - Notepad 





File Edit Format View Help 
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The data should now have been transferred into the notepad editor. 


42. Select File->Save from the menu in the notepad editor (or use Ctrl+S). 









aerelalnainitistorastnre atosaurra 
(alvehurnaneonaceanlnyune/ Surnames 


__43. Close the notepad editor (either Alt+F4 or File->Exit). 


ee | 










ibe eee “vane ai etetig eer ecto ce 
ea rinyaenvae stint staia istanaten tt teen iesstnete ah iat te 
rae contiaica ayers 











jontinesi2-U0:O0« complet sort mesa) tratler.«/saleenvetope>” 
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44, Return to the Windows Explorer window. The new TestFile1.txt file should be visible. 
__45. Select the TestFile1.txt file. 


__46. Press the right mouse button. 


47. Select Copy from the menu. 























48. Select the Input directory above the file. 


49. Press the right mouse button. 


50. Select Paste from the menu 


“ruse Name Datemosiied ‘Type Se 
om 
Like 
Ries input 7AR/03 400 AM Fleflder 
2 coo. A 
B Output Filefolder 
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he Uh resoces Feeder 

ee 1B wotspace 7820131235 86 Folder 

Steines (9 polAtczuntedaah rerc02413 9M _ BATCH Fie 3K 
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Boo Pont 

denier sie 

Fi rcein Open wth . 

i ies Restores veione 
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yale Sendo , 
1D Resouces cw 
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1B ba cache =e 

Ss ew 




















Include inibrany) > Shaewth v —Newfoker 
Twit Name . Daemodiied Type Si 
“ Aopstios 
coro ie 
wou om Sb 
om Resource 
Bentsen seoeny 
(f oahp Li AccountUpdate,batch meee 
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__51. Return to the MQ Explorer and wait for a refresh cycle. 


__52. The queue depth of the LARGE_MESSAGING_ SLICES queue should now be twenty. 


Queues 


Filter: Standard for Queues 








7 Queue name Queue type Open input count Open output count Current q 
i LABSTATE Local () ° 0 
ig L8.US.0UT Local ° ° ° 
(Gl LARGE MESSAGING ERROR Local o o ° 
(Gl LARGE MESSAGING IN Local 1 ° 0 
LARGE MESSAGING MALEORMED MESSAGE Local 0 0 0 
LARGE, MESSAGING SLICES 0 2 20 
0 2 2 
(IMAP ACCTCLOSE Tocat 7 7 7 


__53. Return to the Integration Toolkit. 


__54, Close the Test Client. 





__55. Press the No button. The changes to the test client will not be saved. 





© SeveResource I =. J 


@ "SamplelnputMessage' has been modified. Save changes? 
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56. Minimize the Windows Explorer window. 

















CO) [ E+ Computer > Local Disk(C) » student > Files » 
| onenize + open » Print New older =) 
Bsudent +) tame ‘ Date modlfed Type Size 
Aalts 
oe pe syavrai2si7PM Fleer 
ey Output 9/24/201253) PM File folder 
ti “Us Resources A2/MAOZI04PM File folder 
Bi peace “workspace T/5AU3325 0M Filefolder 
[L Accountupaate batch 1y1a/20na 4:13 PR RATCH File 
h) DBinput 
SD osroure | (Stee ATs 
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7.4 Test with a very large file 


This section is optional. A much larger version of the test file will be created. In order to reduce the size 
of the VMWare image the file itself will be created using a small program. Please do not try to examine it 
using a simple editor such as Notepad or WordPad, as itis too large. The program should take about a 
minute to create the large file. 


‘A program has been provided to create a large file with a specified number of records. Two DOS 
command files are provided. One will create a file approximately 1 GB in size. The other will create a 
file approximately 100 MB in size. The larger file (1 GB) will run approximately ten times longer. On a 
typical laptop the 100 MB file will take approximately one minute to process, while the 1 GB file will take 
approximately 10 minutes to process. The message flow will be executed using this large file. The file 
contains the same type of data as the test file that was used but with many more repeating elements. 


The other consideration is the size of the output queue. The maximum depth of the output queue is 
5000 messages. The input file contains many more records than the queue can hold. In a production 
environment the maximum number of messages would have to be increased. However, in this case, a 
program will be run that will both drain the output messages as they are produced and report the rate 
that messages are being read. This will prevent overflowing the queue. On the author's laptop, 
messages are created at about 1500-1600 per second. The 100MB file will contain 100,500 individual 
records and the 1 GB file will contain 1,005,000 individual records. 


The Windows task manager will also be run during the message flow execution, to show the memory 
usage as the flow is running. 


Start a DOS command prompt, using the icon on the task bar. 
__1. Select the icon for a DOS command prompt in the Windows task bar. 
__2. Press the right mouse button 


__3. Select Command Prompt from the menu. 








oP Unpin this program from tacibar 
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Change to the C:\student\Files\Resources directory. 


5. Execute either the Create100MBfile.cmd or the Create1GBfile.cmd command file. 

















tion. All rights reserved. 
Tle. end! 


ating Large File with 100560 
Large file cheated with 100800 records 100359446 bytes 


lc :\student\Files\Resources> 





Alarge file should be created. This will take less than a minute. There is no need to wait for the file to 
be created, 


6. Point the mouse cursor to a blank area of the Windows task bar. 





7. Press the right mouse button 





_8. Select Start Task Manager from the menu. 









Show the desktop 





Y Lock the taskbar 
Properties 
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Select the Performance tab 





Memory usage should be displayed. Since nothing is running the usage should not be changing. 









Windows Task Manager 








File Options View Help 


= = ne Sa 


Pu Usage (CPU Usage History 














Physical Memory Usage History 





system 

4085 Handles 316 
1079 Threads 13 
1223 Processes 2 
368 UpTime 4:16:3257 
Commit (68) 2st 


(E. Resource Monitor. 











Processes: 90 


Physical Memory: 69% 











CPU Usage: 435 





Tab 7 - Working with files Page 337 


IBM Software 


10. Return to the DOS command prompt that was started earlier. 


11. Execute the measure100MB.cmd or the measure1GB.cmd command file, depending on which 
file was created earlier. 


student\Files\Resources CreateLargeFile.exe 20100 
Program CreateLangeFile.exe starting 

creating Large File with 10050 record 

ange file created with 100500 records 100359446 bytes 


student\Files\Resourcedpneasure1 2NB.cnd 


:\etudent\Files\Resources >\student\tools\rfhutil\ngtines2.exe -c 198500 -q LARG| 


313) program start 
‘ight IBM Corp, 2001 /2002/2004/2005/2012 

Kune point interval set to 100 

‘annecting to queue manager TB9QNGR 

evening aiieue EARGE RESSAGING SLICES for input 

Pe nescages duainod fron Q prion to neacurement otant 

leading 160500 messages fron LANGE MESSAGING. SLICES on TRIGHGR vith max wait til 
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__12. Return to the Windows Explorer window. 

__13. Navigate to the C:\student\Files\Resources directory. 
__14. Select the largeFile text file. 

__15. Press the right mouse button. 


_16. Select Cut from the menu. 






Local Disk (C) > student > Files » Resources 


Grgarize » —T)Open Print New folder 





Ce[E > computer | 














Wo) Nene Detemedied Type Se 

Be (H crantlGefile 12apni21249 PM 

Ls pna.cc : a ; 

Baas BH ceas0ovarie 1277720123031 AM 16 
Tl Gesteargeie.cpp 123/20221243 PM 1a 

fb DeRouTE 











Bon ue : es 
| pees [Sy measurel GS heel 





Dh FieProcessn Print 
( measuretv0m 

i Fes eat 

Wine |e Open with 

C Output Restore previous versions 

Resources 
UJ Sento , 

workspace 
Wy Heatincre 
Dh tx 
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__17. Navigate to the C:\student\Files directory. 
__18, Select the Input folder. 


__19. Press the right mouse button. 


20. Select Paste from the menu 














K Medd + Computer Local Disk (Ci) > student » Files > 
Digenize * Open Include nary y Shae with ~ New folder aes - 
‘Apatibe 
= Trp Sc 

ozo — 5 

Ex Resources Operin new window Hae 

Data a mi 

a2t06 patie Shae with , : 
Di AccountUpdstebatch | Restore previous vesions ATCH Fie 





Include ibray , 
Send to , 
on 

7. 





Create short 





After a brief pause messages should start to be written to the output queue. The number of messages 
that are written each second is reported. 


large File created with 100508 records 100359446 bytes 
‘student\Files\Resources measure 0NB.cnd 


student \Files\Resources>\student\tools\rfhut il\ngt ines? .exe -c 108500 -q LARG| 
[i MESSAGING SLICES —n IBIQHGR -d —b 100 -¢ 1200 

Inqtines2.c 02.11 Release version (Dec 12 2012 4 13> program stant 

KC) Copyright IBM Corp, 2001/2032 /2004/2005 2012 

sync point interval set to 100 

connecting to queue manager TB9QNGR 

lopeniing queue LARGE MESSAGING SLICES for input 


draining queue 
20 messages drained from Q prior to measurement start 

Reading 10500 messages from LARGE MESSAGING SLICES on IBQNGR vith max wait tin] 
le of 1208 secs 


bieaaess Esra 
1583 
1550 
1615 
4432 
1515 
1558 
161? 


total ns 591. 
recent average 1583.00 total msgs 
recent average 1566-58 total msgs 
recent average 1582167 total msgs 
yecent average 1545"00 total megs 
recent average 1539-00 total msgs 
recent average 1542/1? total msgs 
recent average 1552786 total msgs 
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Observe the memory usage. Note that the usage is not increasing as the file is being processed. 





1H Windows Task Manager 
File Options View Help 





[Appicatons [ Breceases [Serves] Performance [Netwerng [Users] 





(CPU Usage (CPU Usage History 


Phisical Memory Usage History 





Total Handles 3238 
Cached Threads 1035 
Avalable Processes 2 
Free Up Time 4:17:29:21 

Commit (68) ayn 























Keiel Memory (MB) 
Paged 246 
Nonpaged 73 {Resource Monier. 
Processes:92 CPU Usage: 0% Physical Memory: 71% 
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__21. When the measurement program is complete close the DOS command prompt window. 


22. Close the Windows Task Manager. 





Raminitrston Command Promet 


1289 recent average 1597.10 total msys 
1714 recent 1638730 total sus 
1729 recent 1673°80 total msgs 
1508 recent 1671130 total sys 
1715 recent 1675740 total sys 
1682 recent 1678.08 total 
1698 wecent total 
1698 recent 1686.80 total 
1656 recent average 1681.58 total 

154515 815 nsgs 


closing the input queue <LARGE_MESSAGING_SLICES> 


disconnecting from the queue manager 


Total messages 160500 
total bytes in all messages 105273195 

laveraye message size 104° 

otal number of seconds with at least one message 65 

First time 15:44:11 Last time 15:45:15 seconds 65 

average message rate except Firs! last intervals 1579.63 
Peak messave rate 1729 


le:\etudent\Files\Resources> 





__23. Close the Windows Explorer. 


= Sr 


T. > Computer > Local isk(C) > student » Fes > =| 69] Seach Fi 2 








rey 














Grganse * —Incudeinibray + Shareth + New folder . e 
4D sudet—* Name . D Type ice 
i Appativa Big Shes 
ei J) Outout Fl fold 
i cou 2 
Boss i werespace ' 





J) psxtos 
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7.5 Clean up 
1. — Inthe integration toolkit select the LargeMessagingExecutionGroup integration server. 
2, Press the right mouse button. 


3. Select DeleteIntegration Server from the menu. 


gaco 














DB data Source Explore 


«4 Big Integration Nodes 
4 i IBONODE 
> O& Configurable Services 
> & default 


> \g, LergeMessagingExecutionGro| 


Graph] Use Defined Properties] 


(Properties £2 [Bl Problems) B= Outline] 


Property 
























x kai 





re Bl 





__4. Press the OK button to confirm the deletion. 


Cea am 


@ ‘Are yousure you wish to delete execution group "LargeMessagingExecutionGroup” ? 








ae | 

















This is the end of lab 7. 
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Lab8& DFDL and message model tooling 


8.1 Introduction to message model standards 


‘A message model is used by IBM Integration Bus to model a message format, The message models are 
all based on World Wide Web Consortium (W3C) XML Schema 1.0 (XSD). 


XML Schema is an international standard that defines a language for describing the structure of XML 
documents. It is suited to describing the messages that flow between business applications, and itis 
widely used in the business community for this purpose. IBM Integration Bus uses models that are based 
on XML Schema to describe the structure of all kinds of message formats, including message formats 
that are not XML. 


Data Format Description Language 1.0 (DFDL) is an open standard modeling language from the Open 
Grid Forum (OGF) that builds upon the features of XML Schema 1.0 in order to model and validate all 
Kinds of general text and binary data. It uses standard XSD model objects to describe the logical 
structure of data, together with DFDL annotations that describe the physical text or binary representation 
of data. IBM Integration Bus uses DFDL schema files to describe text and binary data, including industry 
standard formats. 


DFDL is not intended to be used to model XML documents (use normal XML Schema files). 


‘Support for DFDL in IBM Integration Bus includes: 


* DFDL parser and domain, 

+ DFDL schema file creation wizards 

*DFDL schema editor for modeling text and binary data formats. 

+ DFDL Test perspective for testing your DFDL schema files, 

For more information about DFDL, you can go to the Open Grid Forum (OGF) website. IBM Integration 
Bus supports DFDL 1.0, as defined in the following document: Data Format Description Language 
DFDL) 1 


Unlike previous versions of IBM Integration Bus, you don't need to create a Message Set project and a 


Message Set to model a message type (although MRM Message Models are still supported); you just 
have to create a DFDL schema file. 


6=0=0™0 











Message Create Refine Test 

Modeling csv csv Message 

Introduction Message Message Model 
Model Model 
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8.2 Creating a CSV message model 


This lab will create a message model that will model a CSV file. The file has a header record, and 
several detail records, but no trailer record. 


Records are delimited by CRLF characters, and fields within each record are delimited by a comma. 
The Library project type will be used to store the message model. 

This lab will start from a blank workspace. 

__1. Select File->Switch Workspace->Other. 

_2. Use the Browse button to select the C:\student\DFDLiworkspace workspace. 

__3. Press the OK button to continue. 


@ Workspace Launcher ly —_———_ ==) 


Select a workspace 








IBM Integration Toolkit stores your projects in a folder called a workspace, 
Choose a workspace folder to use for this session, 


Loto RET] ~ te 


» Copy Settings 








® [|| 





4. Click New Library 












‘Application Development New. 





‘New Application... 
tegration Service. 
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__5. _ Set the Library name to MessageModellingLibrary. 
_6. Press the Finish button. 


‘Otettey  a 


Create a new library 














ry name [MessegeModellinglibrary 











® a] Co 


__7. Select the MessageModellingLibrary library. 























Press the right mouse button. 


__9. Select Import from the menu 





‘Application Development Export XSDs from Library 
Migrate 


Golnto 
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10. Expand the General folder. 
__11. Select File System. 


12. Press the Next button. 


‘Ont a a 








Select 
Import resources from the local filesystem into an existing project. 


ety 





Select an import source: 





typefiltertet 








+ | General] 
TE Archive File 


15 Existing Projects into Workspace 
[&. Bxisting RAD 6.x Data Definition Project 
q 
Ey Preferences, 

> & vs 

















® SS 
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__13. Press the Browse button for From directory. 
fe) 
|| Fite system ex 
Source must not be empty. , 
rowin 


From directory: 
































Filter Types. Select All Deselect All 


Into folder: MessageModellingLibrary 











Options 
[Overwrte existing resources without waming. 
reate complete folder structure 














@® = | | 
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14, Navigate to the C:\student\DFDLidata directory. 
__15, Select the data directory. 


16. Press the OK button. 








Import fom directory x] 
Selecta drecory to import fom, 
2 DDL = 





Dh resources fa 
> DB workspace fy 

> deaner 

IB FieProcessing 


MB Files A 
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__17. Select the employees.csv file, 


_18. 


Press the Finish button to perform the import. 











File system 


Import resources from the local file system, 








From directory: [ CA\student\DFDL\data 





( date | 














purchases BadPhoneNumberdat 
purchases dat 








Intofolder MessageMedellingLitrary 
Options 


Overwrite edsting resources without warning 





Create complete folder structure 
Advanced >> 
































® <Back || 


Next> 
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__19. Expand the Other Resources folder. 


__20. Double-click the employees.csv file. 


‘Application Development New, 





a Bi MessageModellinglibrary 
[EV Other Resources 









_21 


_22. Press the OK button. 


Select the Select a program from a list of installed programs radio button. 


Windows -_—— x] 





9) Windows can't open tis fe: 
To open ths fle, Windows needs to know what program you want to use to 


‘open it, Windows can go eniine to look itup automatically, or you can manvally 
select from a ist of programs that are installed on your computer. 


File: employees.csv 


\What do you want to do? 





ise the Web service to id the correct 
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__23. Select the Notepad utility. 
__24, Press the OK button. 


‘Open with = 





Choose the proaran you want io use to cpen this fle: 
2 Fle: employees.csv 


Recommended Programs 


WordPad 
icrosoft Corporation Microsoft Corporation 


(Other Programs 














|| Type a description that you want to use for this kind of fie: 





[W] Amays use the selected program to open this kind of fle 
|| theprogrm you wantisrotin thelist ron your computer, you canker the soroprst poarem onthe 


_ Gocesn 
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The file data will be opened in a notepad session. There is a header record and 42 detail records. 


detail record has 12 fields. 
__25. Examine the file data 


__26. Close the notepad window. 








__27. Inthe Integration Toolkit click New. 





‘Application Development 


3B MececcoMoclinglivay 
© other Resouces 
5) enplayses.cov 


__28. Select Message Model from the menu. 





New Artfact 
a Mesage Flow 


5g 






© Message Map 
& ssourite 


Each 
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__29. Select the CSV text radio button. 


_30. Press the Next button. 


2) New| 





Create a new message madel file 


Selectthe message modeltype or format 








XML 
‘SOAP XML XML data for use in Web Services, 
Other XML All other XML data, 


Comma Separated Values data, a delimited text format commonly used as an export 
format by spreadsheets and databases. 


Record-oriented text Text data formats where delimited fields are grouped into records. 
© copot Data for COBOL programs 

c Data for C programs 

Other text or binary All other text or binary data formats. 





Enterprise Information Systems 


‘SAP Data from SAP systems including IDoc and BAPI 
5 Siebel Data fram Siebel systems 
) PeopleSoft Data from PeopleSoft 
JD Edwards Data from JD Edwards systems 
Other 
) CORBAIDL Data from CORBA 
|) © Database record Records from relational databases 
MIME Data for extended email format 
|| O1BM supplied Predefined data format 


Tots Fah 
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__31. Select the Create a DFDL schema file using the wizard to guide you radio button. 
__32. Press the Next button. 
| 


ee ae 


Esra metre arisen 









1 bens echte aati eet dete 
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__33, Make sure that the Project is set to MessageModellingLibrary. 
__34. Enter Employee as the DFDL schema file name. 


__35. Press the Next button. 


New 





Create a Data Format Description Language (DFDL) Schema 





Specify the location and name of the DFDL schema, and specify the name of the message. 





pple er Liter? 0 MessogeModeling ary 
Fle 


|| DFDL schema file name: 





‘Message name: Employee 
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__36. Select the first record is a header check box. 
__37. Enter 12 as the Number of fields. 


__38, Press the Finish button. 























2) New a 
Configure schema for CSV data my 
Provide settings for @ new schema that wll model CSV deta. >| 

Record settings 
End of record character: [Carriage Return && Line Feed - %CRI%LF; 
k records will be 
Field settings 
Number of fields:| = 
(Ci Create default values forfields 
Encoding code page options: 
© Dynamic (provided to the processor by the application at runtime) 
© Fired UIFS 
Global settings 





Escape scheme | CSV Escape Scheme 
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There should be a new folder in the library with an XSD file called Employee.xsd (under the default 
namespace). This is the message model that was just created. This is a standard DFDL XSD, with no 
specific annotations for IBM Integration Bus. 


There is another XSD file under Schema Definitions called "CommaSeparatedformat.xsd". This "Helper 
schema file” was automatically added by the CSV wizard and contains CSV-specitic defaults for all the 
DFDL properties. This is required because DFDL doesn't have built-in defaults, so if an abject needs a 
property, a value must be supplied. To ease this task, the wizard creates a helper DFDL schema for 
each kind of data (COBOL, CSV and others). 


These files are related by an import statement in the schema references section of the Employee.xsd 
file. 
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Take a look at the Representation Properties view on the right-hand side. Notice the “inheritance” icon to 
the right of the "Length Kind" property. (Hint: You might have to adjust the column lengths in the 
Representation Properties view to see the full contents.) 


In this case, the "Length Kind" property was inherited from the "CommaSeparatedFormat" helper 
schema file that the wizard automatically imported. 


__39. Hover over the inheritance icon to discover its origin. 





B & =I cd e e id 
‘Test Parse Model Test Setinize Medel Hide properties Show advanced Shewal actions Focus onzelected Show quickoutlne 1 








ees | Gt 4 RRB i Representation Properties 











nescage global element that macels an ete daciment of dt Employee (Bement) ® 
Se Type | Min Gece] May Occus | Detaule Valu | [Sempra vata} ¥Pe Miter text> 
SRinaye Property Vaue @-| 
Sm sequece 1 1 ‘Comment al 
tb Rl header 1 1 2 General J 
i] record 1 unbound 











‘Add Locel Element 





onl corn/dFa/CommaSeparsteF crmatiCommmaSeparstesFor 
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Take a look at the different parts of the DFDL Editor: 


1) Applications and Libraries and Projects view: In the top of this view you'll find the Applications 
and Libraries and in the bottom the projects. All the DFDL XSD files will be located under the "Schema 
Files” folder inside of a project. 

2) Logical structure view: This is the core of the DFDL Editor. Here you will work with the Message 
Models. 

3) DFDL properties: Shows the DFDL properties of the selected elements in the editor view. These 
were moved from the traditional properties window to provide better viewing. 

4) Outline view: Shows the complete outline of the current DFDL Message Model. 

5) Problems view: In this view you will be able to see all the warning and errors of your project. 

6) Icon Bar: Several actions can be started from the icons in this bar: 





G3 Be a EZ a ey 5 
[Test Parse Model Test Serialze Model Hide properties Show advanced Show all sections Focus on selected Show quick outine 











* Test Parse Model: Launches the DFDL Test Perspective to test-parse sample data against your 
selected message model. 

* Test Serialize Model: Launches the DFDL Test Perspective, to test-serialize sample data by 

using the selected DFDL schema. 

Hide properties: Hides the Representation Properties view. 

‘Show advanced: Shows the advanced Representation Properties. 

‘Show all sections: Shows all the available sections of the DFDL Message Model in the Editor. 

Focus on selected: Shows only the selected element in the Editor. 

‘Show quick outline: Shows a hanging outline view of the message model in the Editor. 
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The DFDL Editor in the center of the screen describes data elements. Expand the header element. 


Take a look at the columns: 


Max Occur 





Name: Name of the data element 
Type: Data type (string, int, Boolean, decimal, date and so on) 
Min Occurs: Minimum amount of occurrences expected (0 or greater) 
laximum amount of occurrences expected (from 1 to unbounded) 
Default Value: Used to provide the logical value of a required element while parsing or 


serializing messages when the element is missing 
+ Sample Test Data: Can be used to generate a logical instance of the model as you will see 














later on 
Type | Min Occurs | Max Occurs | Default Value || Sample Value 
1 i 
1 1 
sequence a a 
[Elheadfieldl string 1 i head_valuel 
[Elheadfield2 string 1 1 head_value2 
[elheadfield3 string 1 1 head valued 
[Elheadfield# string 1 1 head valued 
[Elheadfields string 1 a head values 
[Elheadfield6 string 1 a head values 
[elhead field? string 1 a head value? 
[Elheadfield8 string 1 z head_ values 
[Elhead field string 1 1 head_valued 
lelhead field string 1 1 head_valuelO 
[Elheadfieldl1 string 1 i head_valuelt 
[Elheadfield12 string 1 1 head_valuel? 
(8 [el record 1 unbounded 











‘Add 2 Local Element 
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Fields 6 to 12 will now be deleted from the header element. 
__40. Expand the header element. 

__41, Select head_field6. 

__42, Hold down the Ctrl key and select fields head_field7 through head_field12. 




















= [| Employee 
© [e] header % 1 
lelheadfieldl string 1 1 head valuet 
(elheadfield2 string 1 1 head_value2 
(elheadfield3 string 1 Fy head_value3 
[elheadfield4 string 1. 1 head valued 
[elheadfields string 1. 1 head_value5 
[el head field6_ string 2 i head_value6é_ 
¢ [el head f string ed > head_value7 
s 1 i head_valueS: 
1 1 head _valuel0 
a —— ee 
(ejheadfieldl2 string 1 1 head vaiuel?2 
# [@] record J unbounded 


‘Add a Local Element 
__43. Press the right mouse button. 
__44, Select Delete. 


N.B. You can also just press the Delete key. 














i head valued 
1 head value? 
1 head values 
1 
7 1 
1 1 
(ejheadfieldi2 sting 1 1 head valuel2 
 [E] record 1 unbounded 


‘Add 2 Local Element 
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Change the names of the remaining five header fields as shown. 
__45. Click the name of the first element. 
__48, Change the name as shown. 


__47. Use the down arrow key to move to the next element name. Press the Enter key when the last 
name is changed. 

















Name Type | MinOccur-[Max Occurs | Default Value’ Sample Value 
Employee 
Gow sequence 1 1 
© [el header rT & 
a 1 
string 1 1 head valuel 
string 1 1 head value2 
string 1 1 head valued 
string 1 1 head valued 
string 2 a head values 
& [el record i unbounded 


‘Add 2 Local Element 
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__48, Collapse the header element. 


__49. Expand the record element to show the 12 fields created by the wizard. 





Name Type | MinOccurs| Max Occurs | Default Value| | Sample Value 
[el Employee 
Bom sequence Fy 1 
 [e] header 1 1 
© Le] record 1 unbounded 
Blew sequence 1 1 
[el field 1 1 valuet 
[el field2 1 1 value? 
[| field3 Fi 1 value} 
[el fieldt 1 1 valued 
[el fields 1 1 values 
[el field6 1 1 value6 
[el field? 1 1 value? 
(el fielas 1 a values 
(e| field? 1 1 valued 
[cl fielaio string 1 1 valuel0 
(el fielant sting 4 rT valuelt 
(el fielan2 sting 1 1 valuel2 


‘Add 2 Local Element 
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__50. Change the field names to the following: 


1) EmpNo 7) HireDate 
2) FirstName 8) Job 

3) Midinit 9) EdLevel 
4) LastName 10) Sex 

5) WorkDept 11) BirthDate 
6) PhoneNo 12) Salary 


Again use the down arrow to move from one field to the next. Press the Enter key to complete the 
rename operation. 








Name Type | MinOccurs | Max Occurs | Default Value | Sample Value 
& [B| Employee 
i a 
a 1 
© [record 1 unbounded 

Ee 1 1 

string 2 1 valued 

string 1 ry value2 

string 1 1 valued 

string 1 1 values 

string 1 1 values 

sting 1 1 values 

sting 1 1 value? 

sting 2 a values 

string 1 1 valued 

string 1 1 valuelo 

string 1 1 valued 

sting 1 1 valuel2 


‘Add 2 Local Element 
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__51. Click in the Type column for the HireDate field. 


__52, Select date as the Type. 







Name Type | MinOccurs | Max Occurs _| Default Value] | SampleValue 
= [el Employee 
Bom sequence 1 1 
(® [e| header 1 1 
© Bl record 1 unbounded 
Blew sequence 1 1 
[e] EmpNo a 1 valuel 
[| FirstName 1 1 value2 
[| Midinit 1 1 value3 
(e] LastName 1 1 valued 
[e] WorkDept 1 1 valueS 
[E] PhoneNo 1 1 
















le) HireDate 





[Job faa value’ 
[el EdLevel Anonyme valine? 
(ej Sex EXboolean E valuelo 
[]BirthDate Elbyte valued 
tl satary vez 


‘Add 2 Local Element [Eldateri 


Eldecimat 
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__53. Click in the Type column for the BirthDate field. 


__54. Select date as the Type. 

















Name Type | MinGccurs | Max Occurs | Defeutt Value || Sample Value 
© [E Employee 
om sequence 
& [Bj header 
© Le] record 
owe sequence 
[e] EmpNo valuel 
[| FirstNeme_ value2 
iM tear ioe 
Z| LastName Elie valued 
Ie] WorkDept fuer] values 
{| PhoneNo EiateTime valued 
[El HireDate Bidecimal 2010-12-31 
[E]Job [double values 
[el EdLevel Bitloat valued 
[ese valuel0 
le] BirthDate valuel 
[c| Salary sting 1 1 valuel2 
‘Add a Local Element 
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__55. Click in the Type column for the EdLevel field, 
__58, Select int as the Type. 








Name Type | Min Occurs | Max Occurs | Default Value] [ Sample Value 
[el Employee 
Baw sequence 1 1 
[elheader 1 1 
©) record 7 unbounded 
Bm sequence 1 1 
{| EmpNo sting 1 if valued 
(e] FirstName string 1 1 valued 
[| Miatnit string 1 1 valued 
(| LastName string 1 a valuet 
[Ee] WorkDept string 1 1 values 
[Ee] PhoneNo sting 1 1 values 
[ej HireDate date 1 1 2010-12-31 
[EJJob ring 1 a values 
(Ej EdLevel valued 
{ei sex EXboolean wae 
[E]BirthDate byte 2010-12-31 
[e] Salary date valuel2 


‘Add 2 Local Element Eldatetime 
Eldecimat 
[Eldouble 


= Bifloat 
‘roperties 22 [BI Problems| EB Deploy] = hesinary 


neha ofr] 


L=tintene 
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__57. Click in the Type column for the Salary field. 
__58, Select decimal as the Type. 


























Name Type | MinOccurs| Max Occurs | Default Value] | Sample Value 
[el Employee 
Bom sequence 
( [| header 
5 Le) record 
Elem sequence 
[e] EmpNo valuel 
[| FirstName value? 
[| Mialnit valued 
LastName valued 
[e] WorkDept values 
[| PhoneNo value6 
[| HireDate 2010-12-31 
[E]Job values 
[e] EdLevel 1 
[ese valuelO 
[| BirthDate 2010-12-31 
{El Salary valuel2 
‘Adda Local Element 
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__59. Select the header field under the Employee->sequence elements. 







































ee ae ee ee ee eee 
ee See ee 
Name Tyre ‘Wan Gecurs | Max Occurs R&R) BE 
aes = ; 
: — 2 
Ss Ht 
[i Eenpho ig 1 Teeter 4 
——— 
' i ss 














The terminator is the delimiter between records or between the header and the records. Since a CRLF 
sequence does not consist of printable characters the terminator is entered using special character 
sequences as shown. 


There is a third Separator "%WSP*" which was added by the wizard because it automatically skips blank 
records (white space). "%eWSP" (whitespace) is a DFDL character entity which groups several 
whitespace characters, 


*%WSP*" (optional whitespaces) is a DFDL character class which implies the parser will ignore 
whitespace characters. 
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_80. Select the record element (if necessary). 


__81. Examine the Terminator property. 





Ey Bi 7 a e a Bf 
TextPareMode) TertSeisce Mods! Hie propetiec Show advnced Show al cections Focus oneelatad Show quckoutine Crete logical nctance 


Nene Toe | ereniaie eas 


Leh Employee 


® 
x&/ 5 G8 





Comment 

General 

Content 

‘ccanrences 
MaxOccon 
(Occurs Count nd 

eeasies 


To 


Sample Test Data 





62. Save the message model (Ctrl+S). 
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8.3 Test the message model 
The message model will be tested to validate that it parses the sample data correctly. 


__1. Click the Test Parse Model button. 


& - 
reeset peter onshore 


[ets x(/ BB 


essays clobal lever ts: models ay enlire docurent of da, 












ae ie Mince 
© [eplovee 
oe Serene L 
+ header ni 
2 ieireccrd 1 
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Select the Content from a data file radio button. 





Press the Browse button. 


‘Qreeme 


—— 
|] select message for testing More, | 














ee aaa 





Parser Input 
Select content to be parsed against schema. 
© Content from 'DEDL Test - Serialze' view 











Specify runtime configuration. 
Runtime encoding options 
Provide runtime values for properties which have been configured in the model to be dynamically set. 
More, 





Enceding (code page): UTF-8 7 








Floating point format: {IEEE Non-Extended, 





Byte order: Little endian 





Big endian 


Runtime validation 


Validate data against schema Morea. 


Restore Defaults 

















oo) Gat 
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__4. Select the employees.csv file under the MessageModellingLibrary library. 
__5. Press the OK button. 








Select en nput fle 
2 @ MessageNodelingLibrary 











put file from the file system 





== 
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Press the OK button. 














Message 
Select message for testing. Mor 











= 





Parser Input 
Select content to be parsed against schema. 
© Content from 'DFDL Test - Serialze’ view 
© Content from a data fle 


Inputfile name:* _/MessageModelingLibrary/employees.csv + (Browse. 





Specify runtime configuration. 
Runtime encoding options 
Provide runtime values for properties which have been configured in the model to be dynamically set. 
Mor 











Encoding (code page): UTF-8 








Floating point format: {IEEE Non-Edtended 








Byte order: © Little endian @ Bigendian 


Raven vaio 
[PValdate data ageinst schema Nlore,, 
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Press the Yes button to continue. 


Dcoumiereswh = 


@ ‘The DFDL Test perspective sets up the views needed to help to test DFDL schemas, 











Testing can be done in other perspectives, but the views might not be optimally 
setup by default. 


Do you want to open the DFDL Test perspective now? 


[Remember my decision 











A pop-up dialog should display the results of the parsing test. 


__8. Click the X to close the dialog box. 





| Parsing competed success 





‘eketng anette Fatal cath ening fi any encspaanrst eee ie 
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‘Toxo raracauneed tora aL pase dake San FL Fan Yo cba as, 
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‘The DFDL Test perspective has several views: 


Parse: Allows you to parse a file using the message model in the editor. 

Trace: Has a detailed trace log of the testing activities. Very helpful to find the cause of errors. 
Logical Instance: Gives you a view of the parsed message tree. 

Serialize: Allows you to generate a file from the message model. 





Tees tne Bas 
a a Ey 2 


ene: Everette tno ines ene 


rpc 

















51 Te- Se OL eee oar e eaean- =e 
foe 





x [iesagtadognnenpe =] Mesa enpoer Mengde tng 
Preset 
















5 “onnoze-E-nicragt GSEs '18 mare Eied-Nd ves oe- oF 30.29 C 


ngempratige-ti9 fon Count oat Ogee 


The input text has been highlighted to differentiate the separators (°,") that the parser has detected 
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The Logical instance view is located in the top right corner. This shows the parsed message tree 
for the employees.csv file 





Boro ree araineanes EE tals) 


Messayeroat: ve essed leant) 


F 
2 


5 Brae 
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Boe 
ene 


Expand a few records to check that the parsing was correct. 








Data source: <From DFDL Test~Patse'vicn> 


Message reat: Ewlyee (Messagelalngltary.brkerEugloyce sc) 


“ree ew ow 














Sane Type ale 
1S record o 
pt vestng 0050 
Frans xestng or al 
Mn vestng ® 
Lastine —xeubng even, 
Woribet —xssbng eo 
rane vectra 6739 
Hrebaee sedate 7907 
ae sesh enacen, 
Eaevel seine 6 
Se sesh " Ey 
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‘The XML View tab shows the same parsed records in XML format. 








Ey 
Data source: <Fram DFDL Test - Parse’ view> 


Message root: Enployee (/MessageModelingLibrary_brokerEnployee.xsd) 


<EmpNo type="xs:string'>000050</EmpNo> 


<FirstName type="xs:string">JOHN</FirstNam2> 
<Midinit type="xs:string">B</MidInit> 

















<LastName typ2="xs:string">GEYER</LastName> 
<WorkDept typ2=' 


"xs:string'>EO1</WorkDept> 
<PhoneNo type="xs:string'>6789</PhoneNo> 
<hireDate type="xs:date">1979-08-17</HireDate> 
<Job type="xs:string">MANAGER</Job> 

sEuLevel type="xsiint'>16</EdLevel> 

<Sex type="xs:string">M</Sex> 
<BirthDate typ 























"'xs:date">1955-09-15</BirthDate> 








i 














In the Employee message model, click the Record element. The first record in the input text will 
be underlined. 


= a = 2 ry 5 E, 
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To go to another record in the input text, just change the Repeating Index number. 





FO Tot Parser raw pose eesonoaelenper ne aloo 
[tater Post nc e204 S885 2 





ieee eaecaeshelopa aaa venh Fore ore 
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1980-05-30" 








cyan et mgr] earns) [rn eae et gh FE] 








__10. Click any element in the message model to see where it's located in the input text. 
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The parsers can be run against others’ input text by clicking the Browse button in the input section, 
selecting the file, and clicking the Run Parser button. 


(Sens Erte rr Wir peae ears) 
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__11. Select the DFDL Test - Serialize tab 








5 nero Es rub 





Foro tet Ferees Rue OSL ae oli roel ely oes a sorcrinese 08, dupe elegance ev areal Ue pam 
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Pawel ipa 
Chane 
1 Company 42,123 Street Winches ter-UR 
2 "00010"; "CHRISTINE", 

5 oono20" AE CHARE, 

4 soon039 i 
5 *onuosa) 

é snanaea) 










1975-07-07", 7228 


12. Select <From “DFDL Test - Logical Instance” view> for the Logical instance, using the drop- 
down list. 


__13. Press the Run Serializer icon. 
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__14, The serializer creates a text file from the previously parsed message tree in memory. 

















__15, Click the X icon to dismiss the results dialog. 


"ttc cm a 


ts 
1 Te Here nthe detodba sows eats to crtlhaw the dita dsled the de. lth aro eon othe aba to own theme 
‘Tove the tacecaresdtierureng Ihe sez che pen OL Trace Ue eb lt, ote 


1 Donetipy the message ava 
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The results of the serialization test should appear. The output will now be saved as a file. 


__16. Press the Save to File button (diskette icon). 


(ner ete oF eas 














o 1g off: : 
Fr Test Sean: Fr Btn wth Fe ated rete shasta oa eres TS HTERS 


Solna TGS eS] | ter es tat dean 





3) cuoo20 reeweL 1 tours, 832,346, 2003-30-i0 nance {B/N 1978-02-02,94230 
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1) 000090° ELLERY Ww.HENDER304.£11.5498.2000-08-15.MANAGER .16.F.1971-05-18.83750 
5 cnotan-removoke 19 seenseR,21-0872,2000-5 


Hi 






















__17. Select the MessageModellingLibrary as the parent folder. 


__18. Enter employee_output.csv as the File name. 


__19. Press the OK button. 


Save As 





> 
Save file to another location. 





Enter or select the parent folder 
MessageModelingLibrary 


fey 














File name: | oe | ‘output.csv 


@ 
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Close the DFDL Test perspective. 
__20. Select the DFDL Test perspective tab in the upper right corner. 
21. Press the right mouse button. 
__22. Select Close from the menu. 
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__23. Close the Employee.xsd tab. 





This lab has provided a brief introduction to some of the new capabilities that have been provided with 
the DFDL parser. The DFDL domain should be the parser of choice for all non-XML data formats. 


This is the end of Lab 8. 
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Appendix A. Notices 
This information was developed for products and services offered in the U.S.A. 


IBM may not offer the products, services, or features discussed in this document in other countries. 
Consult your local IBM representative for information on the products and services currently available in 
your area. Any reference to an IBM product, program, or service is not intended to state or imply that 
only that IBM product, program, or service may be used. Any functionally equivalent product, program, or 
service that does not infringe any IBM intellectual property right may be used instead. However, it is the 
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter described in this 
document. The furnishing of this document does not grant you any license to these patents. You can 
send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

North Castle Drive 
Armonk, NY 10504-1785, 
USA. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property 
Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106-0032, Japan 


The following paragraph does not apply to the United Kingdom or any other country where such 
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES 
CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, 
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some 
states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this 
statement may not apply to you. 


This information could include technical inaccuracies or typographical errors. Changes are periodically 
made to the information herein; these changes will be incorporated in new editions of the publication. 
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for convenience only and do not in 
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part 
of the materials for this IBM product and use of those Web sites is at your own risk. 


IBM may use or distribute any of the information you supply in any way it believes appropriate without 
incurring any obligation to you. 


Any performance data contained herein was determined in a controlled environment. Therefore, the 
results obtained in other operating environments may vary significantly. Some measurements may have 





Page 384 Discovering the value of IBM Integration Bus v9 for your ESB and SOA 


IBM Software 


been made on development-level systems and there is no guarantee that these measurements will be 
the same on generally available systems. Furthermore, some measurements may have been estimated 
through extrapolation. Actual results may vary. Users of this document should verity the applicable data 
for their specific environment. 


Information concerning non-IBM products was obtained from the suppliers of those products, their 
published announcements or other publicly available sources. IBM has not tested those products and 
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM 
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of 
those products. 


All statements regarding IBM's future direction and intent are subject to change or withdrawal without 
notice, and represent goals and objectives only. 


This information contains examples of data and reports used in daily business operations. To illustrate 
them as completely as possible, the examples include the names of individuals, companies, brands, and 
products. All of these names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. All references to fictitious companies or individuals are 
used for illustration purposes only. 


COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which illustrate programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs 
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing 
application programs conforming to the application programming interface for the operating platform for 
which the sample programs are written. These examples have not been thoroughly tested under all 
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these 
programs. 
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Appendix B. Trademarks and copyrights 


The following terms are trademarks of International Business Machines Corporation in the United States, 
other countries, or both: 


em ax cics ClearCase ClearQuest —_Cloudecape 
Cube Views 082 developerWorks ORDA ws IMSIESA 
Informic Lous Lous Worklow —-MOSeros OnniFing 

Rational Redbooks Ped Bick RequistePro System 

‘system 2 Tivol Websphere Workplace systemp 


‘Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or 
trademarks of Adobe Systems Incorporated in the United States, and/or other countries. 


IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications 
Agency which is now part of the Office of Government Commerce. 


Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Inte! Centrino logo, Celeron, Intel Xeon, Intel 
‘SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its 
subsidiaries in the United States and other countries. 

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both 


Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the 
United States, other countries, or both. 


ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet 
Office, and is registered in the U.S. Patent and Trademark Office. 


UNIX is a registered trademark of The Open Group in the United States and other countries. 


Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or 
its affiliates. 


Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other 
countries, or both and is used under license therefrom. 


Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. 
and Quantum in the U.S. and other countries. 
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